Penjejakan kitaran — format eksport JSON

Dokumentasi untuk struktur penjejakan kitaran dalam eksport JSON

Last updated: April 5, 2026

Pada halaman ini

Penjejakan kitaran

Data Penjejakan kitaran merangkumi semua maklumat berkaitan kitaran haid yang direkodkan dalam Apple Health, seperti aliran haid, kualiti mukus serviks, suhu badan basal, keputusan ujian ovulasi dan data berkaitan kitaran lain. Dalam eksport JSON, data penjejakan kitaran disimpan dalam tatasusunan cycleTracking.

Struktur

Setiap entri penjejakan kitaran mengikut struktur konsisten:

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

Medan

Medan wajib

  • start (Rentetan): Tarikh dan masa mula entri dalam format yyyy-MM-dd HH:mm:ss Z
  • end (Rentetan): Tarikh dan masa tamat entri dalam format yyyy-MM-dd HH:mm:ss Z
  • name (Rentetan): Jenis data penjejakan kitaran (lihat jenis di bawah)
  • value (Rentetan): Nilai atau keputusan untuk entri ini (berbeza mengikut jenis)

Medan pilihan

  • isCycleStart (Boolean): Menunjukkan jika entri ini menandakan permulaan kitaran haid baharu. Hanya hadir untuk entri Aliran haid apabila true.

Jenis penjejakan kitaran

Aliran haid

Menjejak pendarahan haid dengan tahap aliran dan maklumat permulaan kitaran.

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

Nilai mungkin:

  • "None"
  • "Light"
  • "Medium"
  • "Heavy"
  • "Unspecified"

Nota: isCycleStart hanya disertakan apabila true, menunjukkan permulaan kitaran haid baharu.

Kualiti mukus serviks

Menjejak kualiti mukus serviks, yang boleh menunjukkan status kesuburan.

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

Nilai mungkin:

  • "Egg White" — Mukus jernih, regang (paling subur)
  • "Watery" — Mukus nipis, berair
  • "Creamy" — Mukus pekat, berkrim
  • "Sticky" — Mukus melekit
  • "Dry" — Sedikit atau tiada mukus

Suhu badan basal

Ukuran suhu badan basal (BBT) dieksport sebagai metrik kesihatan, bukan entri penjejakan kitaran. Cari "Basal Body Temperature" dalam tatasusunan metrics.

Keputusan ujian ovulasi

Merekod keputusan daripada ujian ramalan ovulasi.

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

Nilai mungkin:

  • "Positive/Peak" — Kesuburan puncak dikesan
  • "High" — Tahap kesuburan tinggi
  • "Negative/Low" — Tahap kesuburan rendah
  • "Indeterminate" — Keputusan ujian tidak jelas

Keputusan ujian progesteron

Merekod keputusan daripada ujian progesteron.

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

Keputusan ujian kehamilan

Merekod keputusan daripada ujian kehamilan.

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

Aktiviti seksual

Menjejak aktiviti seksual dalam konteks penjejakan kitaran.

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

Nota: Aktiviti seksual juga mungkin muncul dalam metrik kesihatan dengan butiran penggunaan perlindungan.

Kehamilan

Menjejak tempoh kehamilan.

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

Menyusu

Menjejak tempoh menyusu.

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

Kontraseptif

Menjejak tempoh penggunaan kontraseptif.

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

Ketidakteraturan kitaran

Jenis berikut menjejak pelbagai ketidakteraturan kitaran:

Kitaran haid tidak kerap

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

Kitaran haid tidak teratur

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

Pendarahan antara haid

Pendarahan yang berlaku antara tempoh.

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

Pendarahan haid berterusan

Pendarahan lanjutan atau berterusan.

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

Tempoh haid berpanjangan

Tempoh yang berlangsung lebih lama daripada biasa.

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

Contoh: entri kitaran lengkap

[
  {
    "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": ""
  }
]

Kes penggunaan

Data penjejakan kitaran berguna untuk:

  • Penjejakan kesuburan: Pantau ovulasi dan kenal pasti tingkap subur
  • Analisis kitaran: Jejak panjang kitaran, keteraturan dan corak
  • Pemantauan kesihatan: Kenal pasti ketidakteraturan atau perubahan dalam corak kitaran
  • Perancangan kehamilan: Gunakan data untuk perancangan konsepsi
  • Perkongsian penyedia penjagaan: Kongsi data kitaran dengan doktor ginekologi atau pakar kesuburan
  • Korelasi gejala: Rujuk silang data kitaran dengan metrik kesihatan lain

Data berkaitan

Sesetengah data berkaitan kitaran mungkin muncul dalam bahagian lain:

  • Suhu badan basal: Terdapat dalam tatasusunan metrics sebagai metrik kesihatan
  • Aktiviti seksual: Juga mungkin muncul dalam metrik kesihatan dengan butiran penggunaan perlindungan

Petua

  • Log konsisten: Log berkala menyediakan ramalan kitaran lebih tepat
  • Gabungkan jenis data: Menggunakan berbilang kaedah penjejakan (aliran, mukus, suhu, ujian) memberikan gambaran paling menyeluruh
  • Penanda permulaan kitaran: Gunakan isCycleStart untuk mengenal pasti permulaan setiap kitaran untuk analisis

Dokumentasi berkaitan