主要功能
- 多种时间输入格式:既可以自动识别常见数据,也可以明确选择Unix秒、Unix毫秒、UTC日期时间、UTC日期、ISO-8601时间、儒略日(JD)、修正儒略日(MJD)。
- GPS时间字段的转换:本页面可以输出UTC时间、GPS时间显示、GPS周编号、周内秒、GPS总秒数、Z计数、闰秒、10位周编号。
- 单次处理和批量处理:可以输入一个时间进行快速转换,也可以逐行粘贴批量文本,或选择一个或多个TXT/CSV文件。
- 闰秒和精度的设置:既可以自动计算历史闰秒,也可以根据设备日志或特定数据要求手动指定,并可将秒的小数位数设置为0、3、6。
- 批量取值规则:导入CSV时,可以指定取值列,并使用“跳过第一行”和“删除外层引号”来处理常见的表格数据。
- 保存设置:可以保存输入格式、闰秒模式、输出精度、导出字段,并在下次打开页面时重复使用。
操作前的准备
- 准备UTC日期时间、Unix时间戳、ISO-8601时间、JD或MJD数据。使用JD或MJD时,页面建议明确选择对应格式。
- 不带时区的日期时间将被解释为UTC。ISO格式可以包含以下内容
Z或+08:00以及其他时区偏移。 - 批量文本每行必须包含一个时间条目。对于TXT/CSV文件,需要确认包含时间的列,默认读取第1列。
- 如果CSV包含标题行,可以勾选“跳过第一行”。如果字段有成对的外层引号,可以保持“删除外层引号”启用。
详细操作步骤
-
选择时间格式并设置转换参数
在“使用工具”区域打开“参数设置”。首先在“时间格式”中选择自动识别或明确的数据类型。对于批量导入,接着设置CSV/TXT的取值列、是否跳过第一行以及是否删除外层引号。
接下来,选择闰秒模式。对于常见数据,可以使用“自动计算闰秒”。仅在设备日志或特殊场景提供了明确的闰秒值时,才切换为手动指定。根据需要选择秒的小数位数,并勾选需要保留的导出字段。确认后,可以点击“保存设置”,再点击“下一步:输入时间”。
图1:选择输入格式、闰秒模式、输出精度、导出字段 -
选择输入方式并准备开始转换
进入“输入处理”后,从“单次转换、批量文本、文件导入”中选择一种方式。单次转换可以在输入框中输入UTC时间或Unix时间戳。批量文本按每行一条粘贴。文件导入选择页面明确支持的TXT或CSV文件。
单次转换页面还有“当前UTC、日期时间示例、Unix秒示例、GPS开始时间、JD示例”等快捷按钮,可以用来了解输入格式。确认当前设置和输入内容后,点击“开始转换”。本教程仅展示按钮位置,不提交测试数据。
图2:选择输入方式,在对应区域添加时间数据后开始转换 -
查看结果状态并导出所需数据
点击顶部的“结果导出”或输入页面的“查看结果”,进入结果区域。如果尚未执行转换,页面会显示“暂无结果”的提示,复制和导出按钮也无法使用。完成转换后,与页面提供的结果内容进行核对。
单个结果可以使用“复制结果”。批量结果可以导出为CSV或JSON。右侧的“当前设置”会继续显示输入格式、闰秒模式、取值列、输出精度,并列出GPS时间、GPS历元、每周秒数、Z计数的公式,以便确认当前配置。
图3:在结果页面查看状态,并根据需要复制或导出数据
主要参数说明
| 参数 | 功能 | 选择建议 |
|---|---|---|
| 时间格式 | 指定输入数据的解析方式,包括自动识别、Unix秒/毫秒、UTC日期时间、UTC日期、ISO-8601、JD、MJD | 对于普通日期或时间戳,可以先尝试自动识别。对于JD和MJD,建议明确选择 |
| CSV/TXT的取值列 | 批量粘贴或导入CSV时,从指定列读取时间值 | 默认为第1列。请根据文件中的实际列号调整 |
| 跳过第一行 | 忽略CSV或文本的第一行 | 第一行包含字段标题时,请勾选 |
| 删除外层引号 | 删除字段最外层成对的引号 | 页面默认勾选。对于常见的CSV数据,可以保持启用 |
| 闰秒模式 | 选择自动计算历史闰秒或手动指定秒数 | 通常请使用自动计算。仅在有明确的设备规则时才手动指定 |
| 手动闰秒 | 以秒为单位任意输入GPS与UTC之间的差值 | 请切换到手动闰秒模式后使用 |
| 秒的小数位数 | 控制秒字段保留0、3、6位小数中的哪一种 | 请根据数据精度选择。页面默认为3位 |
| 导出字段 | 控制结果中保留的UTC和GPS时间、周编号、周内秒、总秒数、Z计数、闰秒、10位周编号 | 为避免缺少后续分析所需的内容,请仅取消选择确定不需要的字段 |
结果的查看和保存
结果页面会显示与处理方式对应的内容。单次转换用于查看完整指标并复制结果。批量转换在页面上预览前20条,CSV或JSON导出包含所有成功和失败的记录。如果结果区域仍显示“等待转换”,或按钮无法使用,则需要先返回输入页面,完成参数确认,添加数据并执行转换。
查看结果时,可以对照右侧的公式确认其含义。GPS时间是UTC加上闰秒,GPS历元为1980-01-06,每周秒数为604800,Z计数通过将周内秒除以1.5计算。页面还说明,GPS周编号是完整周编号,10位周编号是完整周编号除以1024的余数。
常见问题和使用建议
自动识别适合什么样的数据?
页面说明,自动识别适合常见数据。对于JD和MJD,建议在“时间格式”中明确选择,以减少格式判断的歧义。
不带时区的日期时间会如何处理?
页面将它们视为UTC。如果需要表示其他时区,则需要使用带有以下内容的格式Z或+08:00ISO格式的其他此类偏移。
为什么无法编辑“手动闰秒”输入框?
默认选择“自动计算闰秒”时,此输入框处于禁用状态。输入明确的秒数之前,请将闰秒模式切换为“手动指定闰秒”。
批量CSV处理读取了错误的字段时该怎么办?
请返回参数设置,确认“CSV/TXT的取值列”是否与包含时间字段的列一致。如果文件有标题行,请勾选“跳过第一行”,如果字段有外层引号,请保持删除选项启用。
结果页面没有内容,复制和导出按钮无法使用时该怎么办?
页面表明转换尚未完成。请返回输入步骤,确认已添加与所选格式一致的时间数据,然后点击“开始转换”。
GPS周编号和10位周编号有什么区别?
页面说明,GPS周编号是从GPS历元开始累计的完整周编号。10位周编号是完整周编号除以1024的余数,可用于调查GPS周回 rollover。
为什么批量页面只显示部分结果?
页面明确说明,批量预览仅显示前20条,而导出的CSV或JSON包含所有结果,因此预览条数较少并不意味着其余记录未包含在导出中。