TeamCalendar
Idioma

Documentação

O que é o formato de arquivo ICS?

Internet Calendaring and Scheduling

ICS é um formato de arquivo que permite aos usuários da internet compartilhar eventos de agenda com outros usuários, por meio do compartilhamento de arquivos ou do envio de e-mails. Os arquivos ICS costumam ser usados para enviar convites de reunião a outras pessoas ou para assinar agendas de feriados ou de aniversários. Os arquivos podem ser abertos e importados por diversos programas de agenda, como Microsoft Outlook, Google Calendar e Apple Calendar.

O formato de arquivo ICS é definido na RFC 5545, a Internet Calendaring and Scheduling Core Object Specification. O formato se baseia no formato anterior vCalendar, que foi definido na RFC 2445.

Os arquivos ICS são arquivos de texto simples que contêm informações de eventos de agenda. Eles podem incluir detalhes como a descrição do evento, os horários de início e de término, o local e outras informações. Os arquivos também podem incluir informações sobre eventos recorrentes, como reuniões semanais ou aniversários mensais, e, no caso do TeamCalendar.com, tabelas de jogos.

Como o ics é um arquivo de texto simples, ele também é bem fácil de ler. Veja como é um exemplo de entrada isc. É isso que o TeamCalendar entrega ao seu app de agenda.

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

O arquivo de texto é bem fácil de entender se você o ler de cima para baixo.

  • BEGIN:VEVENT - Este é o início de um novo evento
  • UID - Este é um identificador único do evento
  • DTSTAMP - Esta é a data e a hora em que o evento foi criado
  • SUMMARY - Este é o título do evento
  • DESCRIPTION - Esta é a descrição do evento
  • LOCATION - Este é o local do evento
  • DTSTART - Esta é a data e a hora de início do evento. Para lidar com fusos horários, o TeamCalendar publica todas as datas e horas no Tempo Universal Coordenado (também conhecido como UTC). Depois, o Google ou o Outlook converte para o seu fuso horário atual. Isso ajuda muito, principalmente em viagens, quando sua agenda muda de fuso horário automaticamente.
  • DTEND - Esta é a data e a hora de término do evento. O TeamCalendar só sabe a hora de término de um evento depois que ele acaba; por isso, para preencher sua agenda, usamos por padrão a duração média de um jogo da liga daquela agenda.
  • GEO - Esta é a geolocalização do evento. Ajuda muito a traçar rotas de carro sem um endereço exato. Útil em eventos internacionais, em que os endereços têm outro formato (ou não existem). Rotas de carro (Apple Maps, Google Maps, Waze etc. sabem navegar a partir de coordenadas de GPS).
  • X-APPLE-STRUCTURED-LOCATION - Este é o local estruturado do evento
  • CREATED - Esta é a data e a hora em que o evento foi criado - usada internamente pelo TeamCalendar
  • LAST-MODIFIED - Esta é a data e a hora da última alteração do evento - usada internamente pelo TeamCalendar. Atualizamos esse campo quando o evento muda, o que avisa o Google/a Microsoft/a Apple de que o evento foi atualizado.
  • BEGIN:VALARM - Este é o início de um novo alarme
  • ACTION - Esta é a ação do alarme
  • DESCRIPTION - Esta é a descrição do alarme
  • TRIGGER - Este é o gatilho do alarme
  • END:VALARM - Este é o fim do alarme
  • END:VEVENT - Este é o fim do evento

Mais artigos