❀next() Packaged Middleware
Have ideas to improve npm?Join in the discussion! Β»

calendar-link
TypeScript icon, indicating that this package has built-in type declarations

2.0.15Β β€’Β PublicΒ β€’Β Published

πŸ“… Calendar Link

Status
Build Node CI Dependencies GitHub release (latest by date) Snyk Vulnerabilities for GitHub Repo
Health License Coverage Pull Request Labeler
PRs Feature Branch Pull Request Hotfix Branch Pull Request Merge PRs
Community NPM type definitions NPM All contributors

JavaScript library to generate an event link for Google Calendar, Yahoo! Calendar, Microsoft Outlook, etc.

NPM

Usage

// 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
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

Any one of the fields end, duration, or allDay is required.

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.

License

MIT Β© Anand Chowdhary

Contributors

Thanks goes to these wonderful people (emoji key):


Anand Chowdhary

πŸ’» πŸ“–

Harry Lachenmayer

πŸ’» πŸ“–

Alexandru-Ionut Imbrea

πŸ’»

Kamran Gh

πŸ’»

Paul Hebert

πŸ› πŸ’»

Osman Mazinov

πŸ“–

Bob Ippolito

πŸ’» πŸ“–

RenΓ© Hellenes

πŸ’»

Andrei Fidelman

πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!

Install

npm i calendar-link

DownloadsWeekly Downloads

11,526

Version

2.0.15

License

MIT

Unpacked Size

61 kB

Total Files

16

Last publish

Collaborators

  • avatar