iCalendar: el formato iCal para tus ca­le­n­da­rios digitales

Con iCalendar, cualquier persona puede combinar sus citas pro­ce­de­n­tes de distintos programas en un único formato. Estas citas pueden ge­s­tio­nar­se y mo­di­fi­car­se como archivos en un formato estándar. Al tratarse de un estándar global, prá­c­ti­ca­me­n­te cua­l­quie­ra puede trabajar con este tipo de archivos.

iCalendar: de­fi­ni­ción y ex­pli­ca­ción del formato de in­te­r­ca­m­bio de datos

iCalendar es un formato de in­te­r­ca­m­bio de ca­le­n­da­rios para la di­s­tri­bu­ción de elementos del ca­le­n­da­rio, es­ta­n­da­ri­za­do en la RFC 5545. Gracias a este formato es posible co­n­so­li­dar, gestionar y compartir citas pro­ce­de­n­tes de di­fe­re­n­tes apli­ca­cio­nes en PC y sma­r­t­pho­nes dentro de un único ca­le­n­da­rio. El formato se basa en vCalendar, creado en 1998. Con el formato iCal es posible gestionar y compartir de manera práctica todas las citas de distintas apli­ca­cio­nes de ca­le­n­da­rio en un formato uniforme y casi en tiempo real.

¿Qué es iCal?

Según el sistema operativo, los archivos iCalendar pueden utilizar distintas ex­te­n­sio­nes, por lo que muchas personas se preguntan qué si­g­ni­fi­can iCal, ICS o iFBF cuando reciben uno de estos archivos. En todos los casos se trata de ex­te­n­sio­nes del formato iCalendar: .ics, .ifb, .ical y .ifbf hacen re­fe­re­n­cia a archivos en formato iCal, aunque con algunas di­fe­re­n­cias.

• .ical: extensión de archivo utilizada en macOS
• .ics: extensión de archivo empleada en la mayoría de sistemas ope­ra­ti­vos
• .ifb: extensión estándar para in­fo­r­ma­ción de di­s­po­ni­bi­li­dad (libre/ocupado)
• .ifbf: variante utilizada en algunos sistemas macOS como ide­n­ti­fi­ca­dor de archivos de di­s­po­ni­bi­li­dad (libre/ocupado)

Si deseas enviar un evento, debes se­le­c­cio­nar el tipo de archivo del formato iCalendar para guardarlo y enviarlo co­rre­c­ta­me­n­te. Crear un archivo ICS (.ics) suele ser la mejor opción, ya que este formato es co­m­pa­ti­ble con la mayoría de los sistemas ope­ra­ti­vos. Al abrir el archivo, la persona de­s­ti­na­ta­ria puede decidir si acepta o no el evento recibido.

Las ventajas de iCalendar

iCalendar no se limita al simple in­te­r­ca­m­bio de archivos. El formato que utiliza para re­pre­se­n­tar eventos está es­tre­cha­me­n­te vinculado al estándar de correo ele­c­tró­ni­co, ya que sigue la es­pe­ci­fi­ca­ción Mu­l­ti­pu­r­po­se Internet Mail Extension (MIME) y, en concreto, el tipo “text/calendar”. Gracias a este diseño abierto, las entradas del ca­le­n­da­rio en este formato pueden in­te­grar­se prá­c­ti­ca­me­n­te en cualquier contexto, incluso in­se­r­tar­se en páginas web para compartir eventos o publicar citas im­po­r­ta­n­tes. Junto con se­r­vi­do­res WebDAV, uti­li­za­dos para poner archivos a di­s­po­si­ción a través de Internet, es posible si­n­cro­ni­zar los eventos en cualquier momento.

Además, el formato permite in­te­r­ca­m­biar eventos di­re­c­ta­me­n­te a través de Bluetooth o mediante una red personal entre di­s­po­si­ti­vos móviles. De este modo, si durante una reunión de trabajo deseas fijar la próxima cita, puedes enviar esa entrada a todos los asi­s­te­n­tes de forma sencilla. iCalendar también hace posible utilizar la in­fo­r­ma­ción guardada en varias apli­ca­cio­nes, que se si­n­cro­ni­za en tiempo real gracias al propio formato.

El formato iCalendar es co­m­pa­ti­ble con los programas de ca­le­n­da­rio más uti­li­za­dos, que integran los datos del ca­le­n­da­rio di­s­po­ni­bles en la web:

• Google Calendar
• Ca­le­n­da­rio de Android
• Microsoft Outlook
• Ca­le­n­da­rio de Bla­c­k­Be­rry
• Ca­le­n­da­rio de macOS/iOS

¿Qué significa la no­r­ma­li­za­ción mediante RFC 5545?

RFC 5545 define cómo deben es­tru­c­tu­rar­se y co­di­fi­car­se los datos de ca­le­n­da­rio para que puedan ser leídos y pro­ce­sa­dos co­rre­c­ta­me­n­te por di­fe­re­n­tes apli­ca­cio­nes.

El elemento central es una es­tru­c­tu­ra de datos unificada basada en los llamados co­m­po­ne­n­tes del ca­le­n­da­rio, como VEVENT, VTODO, VJOURNAL o VTIMEZONE. Cada uno de estos co­m­po­ne­n­tes sigue una es­tru­c­tu­ra cla­ra­me­n­te definida con campos obli­ga­to­rios y op­cio­na­les que incluyen pro­pie­da­des es­pe­cí­fi­cas, como la hora de inicio, la hora de fin, el lugar o la de­s­cri­p­ción de un evento.

Además, RFC 5545 regula otras pro­pie­da­des, como:

• la sintaxis (formato de texto UTF-8, longitud de línea, saltos de línea),
• los formatos de fecha y hora (incluidas las zonas horarias) y
• la co­di­fi­ca­ción de eventos re­cu­rre­n­tes, por ejemplo mediante la propiedad RRULE.

Así se garantiza que un archivo .ics se in­te­r­pre­te siempre del mismo modo, in­de­pe­n­die­n­te­me­n­te del programa o del sistema operativo utilizado.

Cómo crear un archivo iCal paso a paso

De la teoría a la práctica. Crear una cita funciona del siguiente modo:

1. Abre un documento nuevo en un editor de texto de tu elección. Con la apli­ca­ción adecuada, esto también puede hacerse desde un sma­r­t­pho­ne.
2. A co­n­ti­nua­ción, rellena el archivo siguiendo el esquema estándar de iCalendar, que te ex­pli­ca­re­mos con más detalle en el siguiente paso.
3. Cuando finalices el documento, expórtalo en formato iCalendar. Para ello, guarda el archivo con la extensión “.ics”.
4. Abre un programa de ca­le­n­da­rio de tu elección e importa el archivo .ics como evento. Solo tendrás que hacer clic en el menú co­rre­s­po­n­die­n­te, y el evento se cargará au­to­má­ti­ca­me­n­te desde el di­re­c­to­rio.
5. El evento aparecerá ahora como una entrada en tu ca­le­n­da­rio.

Para que la tra­n­s­fe­re­n­cia de datos funcione co­rre­c­ta­me­n­te y la persona de­s­ti­na­ta­ria pueda importar el evento en su propio ca­le­n­da­rio, debes tra­n­s­mi­tir la in­fo­r­ma­ción en un formato pre­de­te­r­mi­na­do. Cada línea tiene un si­g­ni­fi­ca­do concreto:

Los horarios también siguen un formato es­ta­n­da­ri­za­do:

• Las primeras cuatro cifras indican el año (YYYY): 2019
• Las dos si­guie­n­tes, el mes (MM): 201910
• Las dos últimas, el día (DD): 20191027
• La letra T separa la fecha de la hora: 20191027T

La hora se compone de 6 cifras:

• dos para la hora: 20191027T15
• dos para el minuto: 20191027T1559
• dos para los segundos: 20191027T155954
• la entrada se cierra con una Z: 20191027T155954Z

En el siguiente ejemplo, todas las líneas están co­m­ple­ta­das co­rre­c­ta­me­n­te:

BEGIN:VCALENDAR
VERSION:2.0
PRODID:Cal_App//Daily@Planet
METHOD:PUBLISH
BEGIN:VEVENT
UID:123456789@ejemplo.com
LOCATION:Madrid
SUMMARY:Reunión
DESCRIPTION:Reunión de lanzamiento
CLASS:PUBLIC
DTSTART:20191101T100000Z
DTEND:20191101T120000Z
DTSTAMP:20191027T155954Z
END:VEVENT
END:VCALENDAR

Al abrir el archivo, la persona receptora puede añadir au­to­má­ti­ca­me­n­te el evento a su ca­le­n­da­rio y acceder a toda la in­fo­r­ma­ción relevante, desde el tipo de evento hasta la hora de inicio y fi­na­li­za­ción. Así, el formato iCalendar supone un auténtico ahorro de tiempo, es­pe­cia­l­me­n­te en el ámbito laboral.

In­co­r­po­rar iCalendar en el frontend

En lugar de crear un archivo ICS, también puedes redirigir a los usuarios mediante URL es­pe­cia­les di­re­c­ta­me­n­te a un proveedor de ca­le­n­da­rio en línea, como Google Calendar, Outlook.com o Yahoo Calendar. Estos enlaces abren una nueva ventana de “Añadir evento” en el navegador del servicio co­rre­s­po­n­die­n­te, ya co­m­ple­ta­da con la in­fo­r­ma­ción relativa al título, lugar, de­s­cri­p­ción y hora de inicio y fin.

<a href="https://calendar.google.com/calendar/render?action=TEMPLATE
&amp;text=Release%20Meeting
&amp;details=Status-Update%20%26%20Milestones
&amp;location=Remote%20(Google%20Meet)
&amp;dates=20251010T080000Z/20251010T090000Z
&amp;ctz=Europe/Madrid"
target="_blank" rel="noopener">
Añadir a Google Calendar
</a>

Generar archivos .ics por código

A co­n­ti­nua­ción en­co­n­tra­rás ejemplos prácticos que muestran cómo crear archivos ICS con apenas unas líneas de código. Todos los ejemplos generan un evento llamado “Reunión de la­n­za­mie­n­to” para el 15/10/2025, de 10:00 a 11:00 (Europa/Madrid), con finales de línea correctos (CRLF) y escape básico de ca­ra­c­te­res.

Ejemplo en PHP

En este ejemplo de PHP, primero se define la función auxiliar ics_escape(). Su objetivo es asegurar que ca­ra­c­te­res es­pe­cia­les como comas, puntos y comas, barras in­ve­r­ti­das o saltos de línea se escapen co­rre­c­ta­me­n­te. A co­n­ti­nua­ción, se crea la es­tru­c­tu­ra del archivo ICS en un array, donde cada línea re­pre­se­n­ta un atributo del evento, como el título (SUMMARY), la de­s­cri­p­ción (DESCRIPTION) o el periodo (DTSTART, DTEND). La in­s­tru­c­ción implode("\r\n", [...]) une todas las líneas en un único bloque de texto.

Después, se utilizan dos comandos header() que indican al navegador cómo debe tratar el archivo:

• Content-Type: text/calendar; charset=utf-8 indica que se trata de un archivo de ca­le­n­da­rio en formato iCalendar.
• Content-Disposition: attachment; filename="event.ics" indica que el archivo no debe mostrarse di­re­c­ta­me­n­te en el navegador, sino de­s­ca­r­gar­se au­to­má­ti­ca­me­n­te con el nombre indicado.

Fi­na­l­me­n­te, echo $ics envía el archivo en­sa­m­bla­do al navegador. Al abrir el script PHP (por ejemplo, event.php), se iniciará au­to­má­ti­ca­me­n­te la descarga de event.ics, que podrá im­po­r­tar­se de inmediato en Outlook, Google Calendar o Apple Calendar.

function ics_escape($s) {
    return str_replace(
        ["\\",    ";",    ",",    "\n"],
        ["\\\\","\\;", "\\,", "\\n"],
        $s
    );
}
$ics = implode("\r\n", [
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-php//ES",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@ejemplo.com",
    "DTSTAMP:20251010T080000Z",
    "DTSTART;TZID=Europe/Madrid:20251015T100000",
    "DTEND;TZID=Europe/Madrid:20251015T110000",
    "SUMMARY:" . ics_escape("Release-Meeting"),
    "DESCRIPTION:" . ics_escape("Status-Update & Milestones"),
    "LOCATION:" . ics_escape("Remote (Google Meet)"),
    "END:VEVENT",
    "END:VCALENDAR",
    ""
]);
header('Content-Type: text/calendar; charset=utf-8');                // Informa al navegador: "Este es un archivo .ics"
header('Content-Disposition: attachment; filename="event.ics"'); // Inicia la descarga
echo $ics; // Envía el texto al navegador

Ejemplo en Python

Aquí también, la función ics_escape() asegura que los ca­ra­c­te­res es­pe­cia­les como comas, punto y coma o saltos de línea se en­ma­s­ca­ren co­rre­c­ta­me­n­te. Con datetime.now(timezone.utc) se crea au­to­má­ti­ca­me­n­te una marca de tiempo actual (DTSTAMP) en formato UTC. Las líneas in­di­vi­dua­les del evento, como el título (SUMMARY), se unen luego en un bloque de texto con "\r\n".join([...]). Los saltos de línea CRLF (\r\n) siguen siendo obli­ga­to­rios en el formato ICS.

El comando Path("event-python.ics").write_text(ics, encoding="utf-8", newline="") fi­na­l­me­n­te escribe el contenido como un archivo UTF-8 en el di­re­c­to­rio actual. Después de ejecutar el script, el archivo final event-python.ics está listo y puede im­po­r­tar­se de inmediato en Outlook, Google Calendar o Apple Calendar.

from datetime import datetime, timezone
from pathlib import Path
def ics_escape(s: str) -> str:
    return s.replace("\\", "\\\\").replace(";", "\\;").replace(",", "\\,").replace("\n", "\\n")
ics = "\r\n".join([
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-python//ES",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@ejemplo.com",
    f"DTSTAMP:{datetime.now(timezone.utc):%Y%m%dT%H%M%SZ}",
    "DTSTART;TZID=Europe/Madrid:20251015T100000",
    "DTEND;TZID=Europe/Madrid:20251015T110000",
    f"SUMMARY:{ics_escape('Release-Meeting')}",
    f"DESCRIPTION:{ics_escape('Status-Update & Milestones')}",
    f"LOCATION:{ics_escape('Remote (Google Meet)')}",
    "END:VEVENT",
    "END:VCALENDAR",
    ""
])
Path("event-python.ics").write_text(ics, encoding="utf-8", newline="")
print("Archivo creado: event-python.ics")

Ejemplo en Ja­va­S­cri­pt

El siguiente código Ja­va­S­cri­pt genera el contenido del ca­le­n­da­rio di­re­c­ta­me­n­te en el navegador. Primero, el texto del iCalendar se ensambla en la variable ics. La función icsEscape() garantiza nue­va­me­n­te que ca­ra­c­te­res es­pe­cia­les como comas o saltos de línea se en­ma­s­ca­ren co­rre­c­ta­me­n­te. Mediante Blob(), se crea en memoria un archivo virtual a partir del texto, y URL.createObjectURL() genera una URL de descarga temporal que el navegador in­te­r­pre­ta como si fuera un archivo real.

A co­n­ti­nua­ción, se crea di­ná­mi­ca­me­n­te un elemento <a> invisible con el atributo download, que se activa au­to­má­ti­ca­me­n­te mediante a.click(). De este modo, la descarga del archivo event-browser.ics se inicia sin necesidad de una conexión con el servidor.

<button id="dl">Descargar .ics</button>
<script>
function icsEscape(s) {
    return s
        .replace(/\\/g, "\\\\")
        .replace(/;/g, "\\;")
        .replace(/,/g, "\\,")
        .replace(/\n/g, "\\n");
}
const ics = [
    "BEGIN:VCALENDAR",
    "PRODID:-//example.com//ics-browser//ES",
    "VERSION:2.0",
    "CALSCALE:GREGORIAN",
    "METHOD:PUBLISH",
    "BEGIN:VEVENT",
    "UID:event-123@ejemplo.com",
    "DTSTAMP:20251010T080000Z",
    "DTSTART;TZID=Europe/Madrid:20251015T100000",
    "DTEND;TZID=Europe/Madrid:20251015T110000",
    "SUMMARY:" + icsEscape("Release-Meeting"),
    "DESCRIPTION:" + icsEscape("Status-Update & Milestones"),
    "LOCATION:" + icsEscape("Remote (Google Meet)"),
    "END:VEVENT",
    "END:VCALENDAR",
    ""
].join("\r\n");
document.getElementById("dl").addEventListener("click", () => {
    const blob = new Blob([ics], { type: "text/calendar;charset=utf-8" }); // Crear objeto de archivo
    const url = URL.createObjectURL(blob); // URL de descarga temporal
    const a = document.createElement("a");
    a.href = url;
    a.download = "event-browser.ics"; // Nombre del archivo descargado
    document.body.appendChild(a);
    a.click(); // Inicia la descarga
    a.remove();
    URL.revokeObjectURL(url); // Liberar la URL temporal
});
</script>

Ejemplo en Node.js

Este código inicia un pequeño servidor web Express que pone a di­s­po­si­ción un archivo .ics di­re­c­ta­me­n­te desde el navegador. Cuando alguien accede a http://localhost:3000/event.ics, el manejador app.get(...) genera el texto del iCalendar y lo envía al cliente. La función icsEscape() garantiza, como en los ejemplos an­te­rio­res, que los ca­ra­c­te­res es­pe­cia­les se en­ma­s­ca­ren co­rre­c­ta­me­n­te. Con res.setHeader("Content-Type", "text/calendar; charset=utf-8"), el servidor informa al navegador de que se trata de un archivo de ca­le­n­da­rio. El en­ca­be­za­do Cache-Control: public, max-age=300 permite almacenar el archivo en caché durante 5 minutos. Por último, res.send(ics) envía el archivo generado di­re­c­ta­me­n­te al navegador, que lo de­s­ca­r­ga­rá au­to­má­ti­ca­me­n­te o lo abrirá con la apli­ca­ción de ca­le­n­da­rio co­n­fi­gu­ra­da. El servidor se ejecuta lo­ca­l­me­n­te en http://localhost:3000/event.ics.

import express from "express";
const app = express();
function icsEscape(s) {
    return s
        .replace(/\\/g, "\\\\")
        .replace(/;/g, "\\;")
        .replace(/,/g, "\\,")
        .replace(/\n/g, "\\n");
}
app.get("/event.ics", (req, res) => {
    const ics = [
        "BEGIN:VCALENDAR",
        "PRODID:-//example.com//ics-node//ES",
        "VERSION:2.0",
        "CALSCALE:GREGORIAN",
        "METHOD:PUBLISH",
        "BEGIN:VEVENT",
        "UID:event-123@ejemplo.com",
        "DTSTAMP:20251010T080000Z",
        "DTSTART;TZID=Europe/Madrid:20251015T100000",
        "DTEND;TZID=Europe/Madrid:20251015T110000",
        "SUMMARY:" + icsEscape("Reunión de lanzamiento"),
        "DESCRIPTION:" + icsEscape("Actualización de estado e hitos"),
        "LOCATION:" + icsEscape("Remoto (Google Meet)"),
        "END:VEVENT",
        "END:VCALENDAR",
        ""
    ].join("\r\n");
    res.setHeader("Content-Type", "text/calendar; charset=utf-8"); // El navegador reconoce el tipo MIME
    res.setHeader("Cache-Control", "public, max-age=300");                 // Caché (5 minutos)
    res.send(ics); // Enviar archivo ICS
});
app.listen(3000, () =>
    console.log("http://localhost/event.ics")
);

Archivos .ics en di­fe­re­n­tes clientes de ca­le­n­da­rio

Aunque iCalendar es un estándar abierto, cada apli­ca­ción de ca­le­n­da­rio in­te­r­pre­ta los archivos ICS a su manera. Según el sistema, pueden existir di­fe­re­n­cias en la forma en que los eventos se importan, se si­n­cro­ni­zan y se ac­tua­li­zan.

Google Calendar

En Google Calendar, los usuarios pueden importar archivos .ics ma­nua­l­me­n­te o su­s­cri­bi­r­se a un feed de ca­le­n­da­rio mediante una URL.

Al importar un archivo ICS, los eventos incluidos se tra­n­s­fie­ren una sola vez al ca­le­n­da­rio se­le­c­cio­na­do. Los cambios que realices po­s­te­rio­r­me­n­te en el archivo al­ma­ce­na­do en tu servidor no se ac­tua­li­za­rán au­to­má­ti­ca­me­n­te. Google trata esta opción como una in­s­ta­n­tá­nea.

La su­s­cri­p­ción por URL funciona de manera diferente y solo está di­s­po­ni­ble en la versión web de Google Calendar. Para ello, se­le­c­cio­nas “Otros ca­le­n­da­rios” > “Añadir por URL” e in­tro­du­ces la dirección de un archivo ICS, por ejemplo: https://ejemplo.com/calendario.ics. Google recupera este archivo de forma periódica (no­r­ma­l­me­n­te cada 12 a 24 horas) y actualiza los eventos si se han producido cambios.

Es im­po­r­ta­n­te destacar que Google no acepta enlaces webcal://. Por lo tanto, si deseas ofrecer un enlace de su­s­cri­p­ción en tu página web, deberás utilizar siempre la versión HTTPS de la URL.

Ca­le­n­da­rio de Apple

El Ca­le­n­da­rio de Apple admite el formato iCalendar (.ics) de forma es­pe­cia­l­me­n­te completa y cómoda. Cuando los usuarios descargan un archivo ICS o lo abren desde un correo ele­c­tró­ni­co, el sistema lo reconoce au­to­má­ti­ca­me­n­te y pregunta en qué ca­le­n­da­rio deben im­po­r­tar­se los eventos. También en este caso se trata de una im­po­r­ta­ción única, que no se actualiza au­to­má­ti­ca­me­n­te po­s­te­rio­r­me­n­te.

Mucho más potente es la función de su­s­cri­p­ción, que Apple admite di­re­c­ta­me­n­te a través del esquema webcal://. Por lo tanto, si en tu página web incluyes un enlace como webcal://ejemplo.com/calendario.ics, al hacer clic se abrirá au­to­má­ti­ca­me­n­te el diálogo de ca­le­n­da­rio que pregunta si se desea suscribir a él. Un ca­le­n­da­rio suscrito de este modo se si­n­cro­ni­za au­to­má­ti­ca­me­n­te, por defecto cada pocas horas. Los cambios en eventos exi­s­te­n­tes (misma UID, nuevo DTSTAMP) se in­co­r­po­ran co­rre­c­ta­me­n­te, y las entradas eli­mi­na­das des­apa­re­cen en la siguiente ac­tua­li­za­ción.

Outlook

Microsoft Outlook permite tanto importar archivos ICS de forma puntual como su­s­cri­bi­r­se a ellos. Si abres un archivo ICS con doble clic o lo importas ma­nua­l­me­n­te, Outlook añade los eventos co­n­te­ni­dos al ca­le­n­da­rio se­le­c­cio­na­do. Estos eventos son estáticos, de modo que los cambios po­s­te­rio­res en el servidor no se re­fle­ja­rán en Outlook.

La opción de su­s­cri­p­ción funciona de forma similar a la del Ca­le­n­da­rio de Apple: los usuarios pueden in­tro­du­cir la URL del feed desde “Abrir ca­le­n­da­rio” > “Desde Internet” (por ejemplo, https://ejemplo.com/calendario.ics o también webcal://...). Outlook se suscribe a este ca­le­n­da­rio y lo si­n­cro­ni­za au­to­má­ti­ca­me­n­te a in­te­r­va­los regulares. No­r­ma­l­me­n­te, este intervalo oscila entre 30 minutos y 3 horas, aunque en algunos casos puede ser más largo.

Outlook.com —la versión web— funciona de manera similar desde el punto de vista técnico, aunque a veces actualiza los datos con mayor retraso que la apli­ca­ción de es­cri­to­rio.