Đọc file ICS online

Đọc lịch .ics thành sự kiện JSON, mở rộng lịch lặp RRULE trong khoảng ngày, đổi múi giờ, gộp nhiều lịch và tìm khung giờ trống.

Kết quả

Bấm “Chạy” để xem kết quả.

Gửi nội dung iCalendar qua ics (hoặc body thô text/calendar), file, url / urls (feed công khai, nhận cả webcal://, tối đa 5 mỗi request) hoặc calendars (mảng nội dung hoặc đối tượng {url}) để gộp nhiều lịch. Mỗi sự kiện trả về tiêu đề, mô tả, địa điểm, URL, trạng thái, độ bận, nhóm, người tổ chức và người tham dự, nhắc nhở, start / end theo múi giờ đích timezone (ISO 8601 có độ lệch; YYYY-MM-DD cho sự kiện cả ngày, ngày kết thúc không tính), start_utc / end_utc, thời lượng và múi giờ gốc. Thời gian có TZID dùng múi giờ IANA, hoặc VTIMEZONE trong chính file lịch khi tên không phải IANA (Outlook), một số tên múi giờ Windows được quy đổi, thời gian “floating” được hiểu theo múi giờ đích.

Khi có from / to (ngày tính cả hai đầu, theo múi giờ đích), chuỗi sự kiện lặp được mở rộng: RRULE với FREQ (từ phút đến năm), INTERVAL, COUNT, UNTIL, BYDAY có thứ tự (1FR, -1SU), BYMONTHDAY, BYMONTH, BYYEARDAY, BYHOUR / BYMINUTE / BYSECOND, BYSETPOS và WKST, cùng RDATE, EXDATE và các lần bị dời hoặc huỷ (RECURRENCE-ID). Lịch lặp giữ nguyên giờ địa phương khi đổi giờ mùa hè. Không có khoảng ngày thì sự kiện được trả về như trong file kèm rrule (expand=true để liệt kê các lần đầu); limit giới hạn số kết quả (mặc định 1000, tối đa 5000).

free_slots=true gộp thời gian bận của mọi lịch (bỏ qua sự kiện đã huỷ và sự kiện “rảnh”, sự kiện cả ngày chỉ tính khi all_day_busy=true) và trả về các khoảng trống trong giờ làm việc (work_start, work_end, work_days theo thứ ISO, min_minutes) trong tối đa 62 ngày (mặc định 7 ngày từ hôm nay). Không lưu dữ liệu.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/ics-parse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ics":"BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//APIBox//demo//VI\r\nX-WR-CALNAME:Nhóm dự án\r\nX-WR-TIMEZONE:Asia/Ho_Chi_Minh\r\nBEGIN:VEVENT\r\nUID:standup@example.vn\r\nDTSTART;TZID=Asia/Ho_Chi_Minh:20261116T090000\r\nDTEND;TZID=Asia/Ho_Chi_Minh:20261116T093000\r\nRRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=12\r\nSUMMARY:Họp đầu ngày\r\nLOCATION:Phòng 3\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:demo@example.vn\r\nDTSTART:20261117T070000Z\r\nDTEND:20261117T083000Z\r\nSUMMARY:Demo khách hàng\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n","from":"2026-11-16","to":"2026-11-17","free_slots":true,"work_start":"08:30","work_end":"17:30"}'

const res = await fetch('https://apibox.io.vn/v1/ics-parse', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//APIBox//demo//VI\r\nX-WR-CALNAME:Nhóm dự án\r\nX-WR-TIMEZONE:Asia/Ho_Chi_Minh\r\nBEGIN:VEVENT\r\nUID:standup@example.vn\r\nDTSTART;TZID=Asia/Ho_Chi_Minh:20261116T090000\r\nDTEND;TZID=Asia/Ho_Chi_Minh:20261116T093000\r\nRRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=12\r\nSUMMARY:Họp đầu ngày\r\nLOCATION:Phòng 3\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:demo@example.vn\r\nDTSTART:20261117T070000Z\r\nDTEND:20261117T083000Z\r\nSUMMARY:Demo khách hàng\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
    "from": "2026-11-16",
    "to": "2026-11-17",
    "free_slots": true,
    "work_start": "08:30",
    "work_end": "17:30"
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/ics-parse",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//APIBox//demo//VI\r\nX-WR-CALNAME:Nhóm dự án\r\nX-WR-TIMEZONE:Asia/Ho_Chi_Minh\r\nBEGIN:VEVENT\r\nUID:standup@example.vn\r\nDTSTART;TZID=Asia/Ho_Chi_Minh:20261116T090000\r\nDTEND;TZID=Asia/Ho_Chi_Minh:20261116T093000\r\nRRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=12\r\nSUMMARY:Họp đầu ngày\r\nLOCATION:Phòng 3\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:demo@example.vn\r\nDTSTART:20261117T070000Z\r\nDTEND:20261117T083000Z\r\nSUMMARY:Demo khách hàng\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n", "from": "2026-11-16", "to": "2026-11-17", "free_slots": True, "work_start": "08:30", "work_end": "17:30"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/ics-parse');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"ics":"BEGIN:VCALENDAR\\r\\nVERSION:2.0\\r\\nPRODID:-//APIBox//demo//VI\\r\\nX-WR-CALNAME:Nhóm dự án\\r\\nX-WR-TIMEZONE:Asia/Ho_Chi_Minh\\r\\nBEGIN:VEVENT\\r\\nUID:standup@example.vn\\r\\nDTSTART;TZID=Asia/Ho_Chi_Minh:20261116T090000\\r\\nDTEND;TZID=Asia/Ho_Chi_Minh:20261116T093000\\r\\nRRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=12\\r\\nSUMMARY:Họp đầu ngày\\r\\nLOCATION:Phòng 3\\r\\nEND:VEVENT\\r\\nBEGIN:VEVENT\\r\\nUID:demo@example.vn\\r\\nDTSTART:20261117T070000Z\\r\\nDTEND:20261117T083000Z\\r\\nSUMMARY:Demo khách hàng\\r\\nEND:VEVENT\\r\\nEND:VCALENDAR\\r\\n","from":"2026-11-16","to":"2026-11-17","free_slots":true,"work_start":"08:30","work_end":"17:30"}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Vì sao một số sự kiện lặp có vẻ lệch một giờ?

Không lệch: mỗi lần lặp giữ giờ địa phương theo múi giờ của sự kiện, nên giờ UTC thay đổi khi bắt đầu hay kết thúc giờ mùa hè, giống các ứng dụng lịch.

Phần nào của RRULE chưa hỗ trợ?

BYWEEKNO và FREQ=SECONDLY; các chuỗi này chỉ trả về lần đầu tiên kèm cảnh báo.

Lịch của tôi có bị lưu lại không?

Không. Lịch được đọc trong bộ nhớ cho từng request rồi bỏ đi; feed URL được tải lại mỗi lần.