HealthyApps Help Center

周期追踪 - JSON 导出格式

JSON 导出中周期追踪结构的文档

Last updated: February 6, 2026

On this page

周期追踪

周期追踪数据包括 Apple Health 中记录的所有月经周期相关信息，如月经流量、宫颈粘液质量、基础体温、排卵测试结果和其他周期相关数据。在 JSON 导出中，周期追踪数据存储在 cycleTracking 数组中。

结构

每个周期追踪条目遵循一致的结构：

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

字段

必需字段

  • start (String): 条目的开始日期和时间，格式为 yyyy-MM-dd HH:mm:ss Z
  • end (String): 条目的结束日期和时间，格式为 yyyy-MM-dd HH:mm:ss Z
  • name (String): 周期追踪数据类型（见下面的类型）
  • value (String): 此条目的值或结果（因类型而异）

可选字段

  • isCycleStart (Boolean): 指示此条目是否标记新月经周期的开始。仅在月经流量条目中，当值为 true 时存在。

周期追踪类型

月经流量

追踪月经出血，包括流量级别和周期开始信息。

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

可能的值：

  • "None" - 无
  • "Light" - 少量
  • "Medium" - 中等
  • "Heavy" - 大量
  • "Unspecified" - 未指定

注意： isCycleStart 仅在值为 true 时包含，表示新月经周期的开始。

宫颈粘液质量

追踪宫颈粘液的质量，这可能表示生育能力状态。

{
  "start": "2024-02-10 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Cervical Mucus Quality",
  "value": "Egg White"
}

可能的值：

  • "Egg White" - 透明、有弹性的粘液（最易受孕）
  • "Watery" - 稀薄、水样的粘液
  • "Creamy" - 浓稠、奶油状的粘液
  • "Sticky" - 粘稠的粘液
  • "Dry" - 很少或没有粘液

基础体温

基础体温（BBT）测量值作为健康指标导出，而不是周期追踪条目。在 metrics 数组中查找 "Basal Body Temperature"。

排卵测试结果

记录排卵预测测试的结果。

{
  "start": "2024-02-12 08:00:00 -0800",
  "end": "2024-02-12 08:00:00 -0800",
  "name": "Ovulation Test Result",
  "value": "Positive/Peak"
}

可能的值：

  • "Positive/Peak" - 检测到最大生育能力
  • "High" - 高生育能力水平
  • "Negative/Low" - 低生育能力水平
  • "Indeterminate" - 测试结果不明确

孕酮测试结果

记录孕酮测试的结果。

{
  "start": "2024-02-15 08:00:00 -0800",
  "end": "2024-02-15 08:00:00 -0800",
  "name": "Progesterone Test Result",
  "value": "Positive"
}

妊娠测试结果

记录妊娠测试的结果。

{
  "start": "2024-02-20 08:00:00 -0800",
  "end": "2024-02-20 08:00:00 -0800",
  "name": "Pregnancy Test Result",
  "value": "Positive"
}

性活动

在周期追踪上下文中追踪性活动。

{
  "start": "2024-02-14 20:00:00 -0800",
  "end": "2024-02-14 20:00:00 -0800",
  "name": "Sexual Activity",
  "value": ""
}

注意： 性活动也可能出现在健康指标中，并包含保护使用详情。

妊娠

追踪妊娠期。

{
  "start": "2024-03-01 00:00:00 -0800",
  "end": "2024-11-15 23:59:59 -0800",
  "name": "Pregnancy",
  "value": ""
}

哺乳

追踪哺乳期。

{
  "start": "2024-11-20 00:00:00 -0800",
  "end": "2025-02-20 23:59:59 -0800",
  "name": "Lactation",
  "value": ""
}

避孕

追踪避孕使用期。

{
  "start": "2024-01-01 00:00:00 -0800",
  "end": null,
  "name": "Contraceptive",
  "value": ""
}

周期不规律

以下类型追踪各种周期不规律：

月经周期稀少

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Infrequent Menstrual Cycle",
  "value": ""
}

月经周期不规律

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Irregular Menstrual Cycle",
  "value": ""
}

经间期出血

在月经之间发生的出血。

{
  "start": "2024-02-15 00:00:00 -0800",
  "end": "2024-02-15 23:59:59 -0800",
  "name": "Intermenstrual Bleeding",
  "value": ""
}

持续性月经出血

延长或持续的出血。

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Persistent Menstrual Bleeding",
  "value": ""
}

月经期延长

持续时间比平时更长的月经期。

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-08 23:59:59 -0800",
  "name": "Prolonged Menstrual Period",
  "value": ""
}

示例：完整周期条目

[
  {
    "start": "2024-02-01 00:00:00 -0800",
    "end": "2024-02-05 23:59:59 -0800",
    "name": "Menstrual Flow",
    "value": "Medium",
    "isCycleStart": true
  },
  {
    "start": "2024-02-10 00:00:00 -0800",
    "end": "2024-02-10 23:59:59 -0800",
    "name": "Cervical Mucus Quality",
    "value": "Egg White"
  },
  {
    "start": "2024-02-12 08:00:00 -0800",
    "end": "2024-02-12 08:00:00 -0800",
    "name": "Ovulation Test Result",
    "value": "Positive/Peak"
  },
  {
    "start": "2024-02-14 20:00:00 -0800",
    "end": "2024-02-14 20:00:00 -0800",
    "name": "Sexual Activity",
    "value": ""
  }
]

使用案例

周期追踪数据可用于：

  • 生育能力追踪：监测排卵并识别易受孕窗口
  • 周期分析：追踪周期长度、规律性和模式
  • 健康监测：识别周期模式中的不规律或变化
  • 妊娠计划：使用数据进行受孕计划
  • 与医疗提供者共享：与妇科医生或生育专家共享周期数据
  • 症状关联：将周期数据与其他健康指标进行交叉引用

相关数据

某些周期相关数据可能出现在其他部分：

  • 基础体温：在 metrics 数组中作为健康指标
  • 性活动：也可能出现在健康指标中，并包含保护使用详情

提示

  • 一致记录：定期记录可提供更准确的周期预测
  • 组合数据类型：使用多种追踪方法（流量、粘液、温度、测试）可提供最全面的图像
  • 周期开始标记：使用 isCycleStart 识别每个周期的开始以进行分析

相关文档