TeamCalendar
Idioma

Documentación

¿Qué es el formato de archivo ICS?

Internet Calendaring and Scheduling (calendarios y agendas en internet)

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. Los archivos ICS se usan a menudo para enviar convocatorias de reunión o para suscribirse a calendarios de festivos o cumpleaños. Varios programas de calendario pueden abrirlos e importarlos, como Microsoft Outlook, Google Calendar y Apple Calendar.

El formato de archivo ICS se define en el RFC 5545, la Internet Calendaring and Scheduling Core Object Specification. Se basa en el formato anterior vCalendar, definido en el RFC 2445.

Los archivos ICS son archivos de texto plano con información de eventos de calendario. Pueden incluir detalles como descripciones de eventos, horas de inicio y fin, ubicaciones y otra información. También pueden incluir información sobre eventos periódicos, como reuniones semanales o cumpleaños, y en el caso de TeamCalendar.com, calendarios deportivos.

Como ics es un simple archivo de texto, también es bastante fácil de leer. Así es una entrada ics 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 hora en que se creó el evento
  • SUMMARY - Es el título del evento
  • DESCRIPTION - Es una descripción del evento
  • LOCATION - Es el lugar del evento
  • DTSTART - Es la fecha y hora de inicio del evento. Para admitir zonas horarias, TeamCalendar publica todas las fechas y horas en Tiempo Universal Coordinado (también llamado UTC). Después, Google u Outlook las convierten a tu zona horaria actual. Esto es muy útil, sobre todo cuando viajas y tu calendario cambia de zona horaria automáticamente.
  • DTEND - Es la fecha y hora de fin del evento. TeamCalendar no sabe cuándo termina un evento hasta que acaba, así que para rellenar tu calendario usamos la duración media de un partido de esa liga.
  • GEO - Es la geolocalización del evento. Muy útil para obtener indicaciones sin una dirección exacta, y para eventos internacionales donde las direcciones tienen otro formato (o faltan). Las apps de navegación (Apple Maps, Google Maps, Waze, etc.) saben guiarte con coordenadas GPS.
  • X-APPLE-STRUCTURED-LOCATION - Es la ubicación estructurada del evento
  • CREATED - Es la fecha y hora en que se creó el evento; TeamCalendar la usa internamente
  • LAST-MODIFIED - Es la fecha y hora de la última modificación del evento; TeamCalendar la usa internamente. La actualizamos cuando el evento cambia, lo que indica a Google/Microsoft/Apple que el evento se ha actualizado.
  • BEGIN:VALARM - Es el inicio de una nueva alarma
  • ACTION - Es la acción de la alarma
  • DESCRIPTION - Es la descripción de la alarma
  • TRIGGER - Es el disparador de la alarma
  • END:VALARM - Es el final de la alarma
  • END:VEVENT - Es el final del evento

Más artículos