---
id: data-export.checkin.howto
title: 导出签到数据
type: howto
feature: data-export
scope: admin
locale: zh
aliases:
  - 导出签到
  - 考勤导出
  - 签到 Excel
  - 打卡数据导出
  - 月度考勤表
related_tools: []
related_pages: [application]
prerequisites:
  - 需要系统管理员权限
  - 系统设置中签到功能已开启（`checkinSetting.open = open`）
negative:
  - 必须先在系统设置打开签到，否则报「此功能未开启」
  - 单次最多 100 个成员
  - 日期范围最多 35 天
  - 必填成员 / 日期 / 时间三个参数，缺一不可
last_verified: v1.7.90
---

# 导出签到数据

## 入口
桌面端：左侧栏「应用」→「数据导出」（仅管理员）→「导出签到数据」。
对应 API：`GET api/system/checkin/export`。

## 前置条件
系统设置 → 签到设置 → 「开启签到功能」必须为开启；未开启会直接返回「此功能未开启，请前往系统设置开启」。

## 操作步骤
1. 进入「数据导出」→ 选「导出签到数据」
2. 选择成员（最多 100 个，必填）
3. 选择日期范围（最多 35 天，必填）
4. 选择班次时间范围，例如 09:00-18:00（必填）
5. 点击「导出」，文件由系统机器人 `system-msg` 私聊推送

## 导出字段
签到人、签到日期、班次时间、首次签到时间、首次签到结果、最后签到时间、最后签到结果、参数数据。每个成员一个 Sheet。

## 结果判定规则
- **首次签到**：晚于班次开始时间标「迟到」（蓝色），无记录标「缺卡」（红色）
- **最后签到**：考虑「延后时间」（默认 120 分钟）支持跨天打卡
- 当前时间还没到班次开始 / 结束时显示 `-`

## 不支持
- 不支持导出无班次成员
- 不支持跨月超 35 天一次导
- 不支持自定义结果判定规则（用系统全局设置）