https://github.com/anandchowdhary/calendar-link
📅 Calendar link generator for popular services
https://github.com/anandchowdhary/calendar-link
calendar calendar-link google-calendar javascript library outlook yahoo
Last synced: about 1 month ago
JSON representation
📅 Calendar link generator for popular services
- Host: GitHub
- URL: https://github.com/anandchowdhary/calendar-link
- Owner: AnandChowdhary
- License: mit
- Created: 2019-01-16T15:51:01.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-31T20:40:41.000Z (about 1 month ago)
- Last Synced: 2025-04-02T12:18:47.352Z (about 1 month ago)
- Topics: calendar, calendar-link, google-calendar, javascript, library, outlook, yahoo
- Language: TypeScript
- Homepage: https://anandchowdhary.github.io/calendar-link/
- Size: 2.6 MB
- Stars: 572
- Watchers: 4
- Forks: 71
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 📅 Calendar Link
| | Status |
| - | - |
| Build |  [](https://libraries.io/github/AnandChowdhary/calendar-link) [](https://github.com/AnandChowdhary/calendar-link/releases) |
| Health | [](https://github.com/AnandChowdhary/calendar-link/blob/master/LICENSE) [](https://coveralls.io/github/AnandChowdhary/calendar-link) |
| Community |  [](https://www.npmjs.com/package/calendar-link)  |
JavaScript library to generate an event link for Google Calendar, Yahoo!
Calendar, Microsoft Outlook, etc.
[](https://npm.im/calendar-link/)
### Usage
```js
// Usage with Node.js
const { google, outlook, office365, yahoo, ics } = require("calendar-link");
// Usage with TypeScript or ES6
import { google, outlook, office365, yahoo, ics } from "calendar-link";
// Set event as an object
const event = {
title: "My birthday party",
description: "Be there!",
start: "2019-12-29 18:00:00 +0100",
duration: [3, "hour"],
};
// Then fetch the link
google(event); // https://calendar.google.com/calendar/render...
outlook(event); // https://outlook.live.com/owa/...
office365(event); // https://outlook.office.com/owa/...
yahoo(event); // https://calendar.yahoo.com/?v=60&title=...
ics(event); // standard ICS file based on https://icalendar.org
```
### Options
| Property | Description | Allowed values |
| ------------------ | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `title` (required) | Event title | String |
| `start` (required) | Start time | JS Date / ISO 8601 string / Unix Timestamp |
| `end` | End time | JS Date / ISO 8601 string / Unix Timestamp |
| `duration` | Event duration | Array with value (Number) and unit (String) |
| `allDay` | All day event | Boolean |
| `rRule` | Recurring event | iCal [recurrence rule](https://www.rfc-editor.org/rfc/rfc5545#section-3.3.10) string
**NOTE:** Only supported by `google` and `ics` |
| `description` | Information about the event | String |
| `location` | Event location in words | String |
| `busy` | Mark on calendar as busy? | Boolean |
| `guests` | Emails of other guests | Array of emails (String) |
| `url` | Calendar document URL | String |
#### Notes
- Any one of the fields `end`, `duration`, or `allDay` is required.
- The allowed units in `duration` are listed here: https://day.js.org/docs/en/durations/creating#list-of-all-available-units.
- The `url` field defaults to `document.URL` if a global `document` object exists. For server-side rendering, you should supply the `url` manually.
Not all calendars support the `guests` and `url` fields.
- If you don't pass the start and end time in UTC, Google will convert it to UTC but Outlook won't, so it's a good idea to use UTC when passing dates and times
- There are some known issues in Office 365 because of which we can't generate a consistent link in all devices (#542)
## Compatibility
This package uses [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) (Node.js >= 10, 97%+ browsers), but if you need to include a polyfill, you can include [url-search-params-polyfill](https://www.npmjs.com/package/url-search-params-polyfill) first.
## License
MIT © [Anand Chowdhary](https://anandchowdhary.com/?utm_source=github&utm_medium=calendar-link&utm_campaign=readme)