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 識別每個週期的開始以進行分析

相關文件