TeamCalendar
Lingua

Documentazione

Cos'è il formato file ICS?

Internet Calendaring and Scheduling

ICS è un formato file che permette agli utenti di Internet di condividere eventi di calendario con altri utenti, condividendo file o inviando email. I file ICS si usano spesso per inviare inviti a riunioni ad altri utenti o per iscriversi a calendari di festività o compleanni. I file possono essere aperti e importati da vari programmi di calendario, tra cui Microsoft Outlook, Google Calendar e Apple Calendar.

Il formato file ICS è definito nella RFC 5545, la Internet Calendaring and Scheduling Core Object Specification. Il formato si basa sul precedente formato vCalendar, definito nella RFC 2445.

I file ICS sono file di testo semplice che contengono informazioni sugli eventi di calendario. Possono includere dettagli come la descrizione dell'evento, l'orario di inizio e di fine, il luogo e altre informazioni. Possono anche contenere informazioni sugli eventi ricorrenti, come riunioni settimanali o compleanni mensili e, per TeamCalendar.com, i calendari delle partite.

Poiché un file ics è un semplice file di testo, è anche piuttosto facile da leggere. Ecco come appare una voce ics di esempio. È ciò che TeamCalendar consegna alla tua applicazione di calendario.

BEGIN:VEVENT
                    UID:9b950757-21e5-4443-afde-8faafdc58101@TeamCalendar.com
                    DTSTAMP:20240317T024915Z
                    SUMMARY:⚾️ Arizona Diamondbacks host St. Louis Cardinals
                    DESCRIPTION:\nhttps://TeamCalendar.com/app/T9qgt4MERu Use this link to Add or Remove team schedules from your TeamCalendar.\n\nThank you for using Te amCalendar.com! If you like our calendar service\, please consider sharing with your friends.
                    LOCATION:Chase Field: Phoenix\, AZ USA
                    DTSTART:20240413T014000Z
                    DTEND:20240413T044000Z
                    GEO:33.445278;-112.066944
                    X-APPLE-STRUCTURED-LOCATION;VALUE=URI;
                    X-ADDRESS=Chase Field: Phoenix\, AZ USA;
                    X-APPLE-RADIUS=72;
                    X-TITLE=Chase Field:geo:33.445278,-112.066944
                    CREATED:20240317T024915Z
                    LAST-MODIFIED:20240331T182349Z
                    BEGIN:VALARM
                    ACTION:DISPLAY
                    DESCRIPTION:⚾️ Diamondbacks host St. Louis Cardinals starts in one hour
                    TRIGGER:-PT60M
                    END:VALARM
                    END:VEVENT

Il file di testo è piuttosto facile da capire se lo leggi dall'alto verso il basso.

  • BEGIN:VEVENT - Indica l'inizio di un nuovo evento
  • UID - È l'identificatore univoco dell'evento
  • DTSTAMP - È la data e l'ora in cui è stato creato l'evento
  • SUMMARY - È il titolo dell'evento
  • DESCRIPTION - È la descrizione dell'evento
  • LOCATION - È il luogo dell'evento
  • DTSTART - È la data e l'ora di inizio dell'evento. Per gestire i fusi orari, TeamCalendar pubblica tutte le date e gli orari in tempo coordinato universale (noto anche come UTC). Poi Google o Outlook li convertono nel tuo fuso orario attuale. È molto utile, soprattutto quando sei in viaggio e il tuo calendario cambia fuso orario in automatico.
  • DTEND - È la data e l'ora di fine dell'evento. TeamCalendar non conosce l'orario di fine di un evento finché non è terminato, quindi per compilare il tuo calendario usiamo come valore predefinito la durata media di una partita, in base alla lega del calendario.
  • GEO - È la geolocalizzazione dell'evento. Molto utile per le indicazioni stradali quando manca un indirizzo esatto. Utile per gli eventi internazionali in cui gli indirizzi hanno formati diversi (o mancano). Indicazioni stradali (Apple Maps, Google Maps, Waze, ecc. sanno tutte navigare a partire dalle coordinate GPS.
  • X-APPLE-STRUCTURED-LOCATION - È il luogo strutturato dell'evento
  • CREATED - È la data e l'ora in cui è stato creato l'evento, usata internamente da TeamCalendar
  • LAST-MODIFIED - È la data e l'ora dell'ultima modifica dell'evento, usata internamente da TeamCalendar. La aggiorniamo quando l'evento cambia, e questo indica a Google/Microsoft/Apple che l'evento è stato aggiornato.
  • BEGIN:VALARM - Indica l'inizio di un nuovo promemoria
  • ACTION - È l'azione del promemoria
  • DESCRIPTION - È la descrizione del promemoria
  • TRIGGER - È ciò che fa scattare il promemoria
  • END:VALARM - Indica la fine del promemoria
  • END:VEVENT - Indica la fine dell'evento

Altri articoli