Detalles Importantes del iCalendar RFC 2445

Acerca del Modelo de Objetos iCalendar de Aspose

Aspose.Email contiene todas las clases proporcionadas por el componente Aspose iCalendar. RecurrencePattern y RecurrenceRule son las clases centrales de Aspose iCalendar, y proporcionan implementaciones concretas de los elementos correspondientes de RFC 2445.

La clase RecurrencePattern representa todo el patrón de recurrencia. Puedes crear un nuevo patrón de recurrencia desde cero utilizando el constructor por defecto o cargar un patrón existente en CalendarRecurrence. La clase RecurrenceRule representa la parte RRULE o EXRULE de un patrón de recurrencia. RecurrenceRule expone una serie de propiedades que se mapean directamente a sus contrapartes en el estándar iCalendar. Por ejemplo, ByMonth se mapea a BYMONTH en iCalendar y así sucesivamente. Al examinar o establecer valores de las propiedades de RecurrenceRule puedes analizar o modificar una regla de recurrencia. Para más información y ejemplos de código, consulta RecurrencePattern y RecurrenceRule en la Referencia de API.

Detalles Importantes del iCalendar RFC 2445

Esta sección incluye los siguientes temas:

• Formatos de Fecha y Hora.
• DATE.
• DATE-TIME con Hora Local.
• DATE-TIME con Hora UTC.
• DATE-TIME con Hora Local y Zona Horaria.
• BYWEEKNO Proporciona Cumplimiento ISO 8601

Formatos de Fecha y Hora

Las fechas, o fechas con horas asociadas, pueden usarse en los elementos DTSTART, UNTIL, EXDATE y RDATE al especificar un patrón de recurrencia. iCalendar define el tipo de valor DATE para identificar valores que contienen una fecha del calendario y también define el tipo DATE-TIME para identificar valores que especifican una fecha del calendario precisa y una hora del día. Los valores DATE-TIME pueden especificarse en tres formas, con:

• Hora local.
• Hora UTC.
• Hora local y zona horaria.

DATE

De acuerdo con el estándar iCalendar, los valores DATE deben seguir el formato yyyyMMdd. El siguiente ejemplo representa el 14 de julio de 1997: 19970714

DATE-TIME con Hora Local

La forma de fecha con hora local es simplemente un valor de fecha-hora que no contiene el designador UTC y no hace referencia a una zona horaria. Por ejemplo, lo siguiente representa el 18 de enero de 1998, a las 11 PM: DTSTART:19980118T230000. Los valores de fecha-hora de este tipo se consideran “flotantes” y no están ligados a ninguna zona horaria en particular. Se utilizan para representar el mismo valor de hora, minuto y segundo, independientemente de qué zona horaria se esté observando actualmente.

DATE-TIME con Hora UTC

La fecha con hora UTC, o tiempo absoluto, se identifica por un carácter de sufijo en LETRA MAYÚSCULA LATINA Z, el designador UTC, que se añade al valor de la hora. Por ejemplo, lo siguiente representa el 19 de enero de 1998, a las 0700 UTC: DTSTART:19980119T070000Z. Ten en cuenta que Aspose iCalendar ignora el sufijo Z del formato UTC y trata la hora como hora local. El estándar RFC2445 establece que una porción de tiempo especificada en la regla UNTIL de un patrón de recurrencia debe estar en formato UTC. Esta es una declaración muy extraña y, de hecho, hay ejemplos en el estándar que se calculan incorrectamente. Aspose iCalendar acepta el tiempo en cualquier formato en la regla UNTIL.

DATE-TIME con Hora Local y Zona Horaria

Para hacer referencia a la zona horaria, DATE-TIME se modifica con la propiedad TZID. Por ejemplo, lo siguiente representa las 2 AM en Nueva York el 19 de enero de 1998: DTSTART;TZID=US-Eastern:19980119T020000. Ten en cuenta que Aspose iCalendar en este momento ignora el parámetro TZID y trata la hora como hora local.

BYWEEKNO Proporciona Cumplimiento ISO 8601

Usa BYWEEKNO solo cuando se requiera conformidad con ISO 8601. Los números de semana, tal como se definen en ISO 8601, son muy diferentes de los números de semana en el sentido normal. Según ISO 8601, la semana número uno del año calendario es la primera semana del año calendario que contiene al menos cuatro días. Esta regla hace que el algoritmo sea específico para aplicaciones que requieren conformidad con ISO 8601 y lo hace casi inaplicable para otros usos. ISO 8601 es admitido por algunas aplicaciones bancarias y financieras europeas. También se utiliza en televisión para reservar comerciales. La regla BYWEEKNO especifica una lista delimitada por comas de números que identifican las semanas del año. Los valores válidos son del 1 al 53 y del 1 al 53. Esto corresponde a las semanas según la numeración de semanas definida en ISO 8601. BYWEEKNO solo es válido para reglas ANUALES.