TeamCalendar
Idioma

Documentación

¿Qué es el formato de archivo ICS?

Internet Calendaring and Scheduling

ICS es un formato de archivo que permite a los usuarios de Internet compartir eventos de calendario con otros usuarios compartiendo archivos o enviando correos electrónicos. Los archivos ICS se usan a menudo para enviar convocatorias de reunión a otros usuarios o para suscribirse a calendarios de festivos o de cumpleaños. Varios programas de calendario pueden abrirlos e importarlos, como Microsoft Outlook, Google Calendar y Apple Calendar.

El formato de archivo ICS está definido en el RFC 5545, que es la Internet Calendaring and Scheduling Core Object Specification. El formato se basa en el formato vCalendar anterior, que se definió en el RFC 2445.

Los archivos ICS son archivos de texto sin formato que contienen información sobre eventos de calendario. Pueden incluir datos como la descripción del evento, la hora de inicio y de fin, el lugar y otra información. También pueden incluir información sobre eventos periódicos, como reuniones semanales o cumpleaños mensuales, y, en el caso de TeamCalendar.com, calendarios deportivos.

Como un ics es un simple archivo de texto, también es bastante fácil de leer. Así es una entrada isc de ejemplo. Esto es lo que TeamCalendar envía a tu aplicación de 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

El archivo de texto es bastante fácil de entender si lo lees de arriba abajo.

  • BEGIN:VEVENT - Es el inicio de un nuevo evento
  • UID - Es un identificador único del evento
  • DTSTAMP - Es la fecha y la hora en que se creó el evento
  • SUMMARY - Es el título del evento
  • DESCRIPTION - Es la descripción del evento
  • LOCATION - Es el lugar del evento
  • DTSTART - Es la fecha y la hora de inicio del evento. Para gestionar las zonas horarias, TeamCalendar publica todas las fechas y horas en tiempo universal coordinado (también conocido como UTC). Después, Google u Outlook lo convierten a tu zona horaria actual. Es muy útil, sobre todo cuando viajas y tu calendario cambia de zona horaria automáticamente.
  • DTEND - Es la fecha y la hora de fin del evento. TeamCalendar no sabe cuándo acaba un evento hasta que termina, así que, para rellenar tu calendario, usamos por defecto la duración media de un partido según la liga del calendario.
  • GEO - Es la geolocalización del evento. Muy útil para obtener indicaciones para llegar en coche sin una dirección exacta. También ayuda en eventos internacionales en los que las direcciones tienen otro formato (o no existen). Las apps de navegación (Apple Maps, Google Maps, Waze, etc.) saben guiarte a partir de coordenadas GPS.
  • X-APPLE-STRUCTURED-LOCATION - Es la ubicación estructurada del evento
  • CREATED - Es la fecha y la hora en que se creó el evento; TeamCalendar la usa internamente
  • LAST-MODIFIED - Es la fecha y la hora de la última modificación del evento; TeamCalendar la usa internamente. La actualizamos cuando el evento cambia, lo que indica a Google, Microsoft y Apple que el evento se ha actualizado.
  • BEGIN:VALARM - Es el inicio de un nuevo aviso
  • ACTION - Es la acción del aviso
  • DESCRIPTION - Es la descripción del aviso
  • TRIGGER - Es lo que activa el aviso
  • END:VALARM - Es el final del aviso
  • END:VEVENT - Es el final del evento

Más artículos