addCalendarEvent

addCalendarEvent là API dùng để thêm một sự kiện mới vào lịch của thiết bị người dùng.

Khả dụng:

Runtime version: 1.0.1

Ví dụ

Thêm sự kiện

import apis from '@v-miniapp/apis'

apis.addCalendarEvent({
  title: 'Họp team',
  startDate: '2026-01-15T09:00:00.000Z',
  endDate: '2026-01-18T10:00:00.000Z',
  location: 'Phòng họp A',
  notes: 'Thảo luận kế hoạch Q1',
  allDay: false,
  success: res => {
    console.log('Thêm sự kiện thành công', res)
  },
  fail: err => {
    console.error('Thêm sự kiện thất bại', err)
  },
})

Thêm sự kiện cả ngày

import apis from '@v-miniapp/apis'

window.apis.addCalendarEvent({
  title: 'Nghỉ lễ',
  startDate: '2026-01-20T00:00:00.000Z',
  endDate: '2026-01-20T23:59:59.000Z',
  allDay: true,
  success: res => {
    console.log('Đã thêm sự kiện cả ngày')
  },
  fail: err => {
    console.error('Lỗi:', err)
  },
})

Thêm sự kiện với đầy đủ thông tin

import apis from '@v-miniapp/apis'

window.apis.addCalendarEvent({
  title: 'Workshop React Native',
  startDate: '2026-02-01T14:00:00.000Z',
  endDate: '2026-02-01T17:00:00.000Z',
  location: 'Tòa nhà ABC, Tầng 5',
  url: 'https://example.com/workshop',
  notes: 'Mang theo laptop và tài liệu học tập',
  allDay: false,
  success: res => {
    console.log('Thêm sự kiện thành công')
  },
  fail: err => {
    alert('Không thể thêm sự kiện: ' + JSON.stringify(err))
  },
})

Tham số

Thuộc tính	Kiểu dữ liệu	Bắt buộc	Mô tả
title	String	√	Tiêu đề của sự kiện
startDate	String	√	Thời gian bắt đầu (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ
endDate	String	√	Thời gian kết thúc (UTC), định dạng: YYYY-MM-DDTHH:mm:ss.SSSZ
location	String		Địa điểm tổ chức sự kiện
allDay	Boolean		Sự kiện có diễn ra cả ngày hay không
url	String		URL liên quan đến sự kiện (chỉ hỗ trợ trên iOS)
notes	String		Ghi chú (notes trên iOS) hoặc mô tả (description trên Android) liên quan đến sự kiện
success	Function		Callback function khi thành công.
fail	Function		Callback function khi thất bại.
complete	Function		Callback function khi hoàn tất tác vụ cho dù thành công hay thất bại.

Lưu ý

• Định dạng thời gian startDate và endDate phải theo chuẩn UTC: YYYY-MM-DDTHH:mm:ss.SSSZ
• Tham số url chỉ được hỗ trợ trên iOS
• Tham số notes sẽ được hiển thị dưới dạng "notes" trên iOS và "description" trên Android
• Người dùng có thể cần cấp quyền truy cập lịch cho ứng dụng khi sử dụng API này lần đầu