Detalles importantes del iCalendar RFC 2445

Acerca del modelo de objetos Aspose iCalendar

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

El RecurrencePattern la clase representa todo el patrón de recurrencia. Puede crear un nuevo patrón de recurrencia desde cero usando el constructor predeterminado o cargar un patrón existente en CalendarRecurrence. El RecurrenceRule la clase representa la parte RRULE o EXRULE de un patrón de recurrencia. RecurrenceRule expone un número de propiedades que se corresponden directamente con sus equivalentes en el estándar iCalendar. Por ejemplo, ByMonth se asigna a BYMONTH en iCalendar, etc. Al examinar o establecer valores de RecurrenceRule propiedades que puede analizar o modificar una regla de recurrencia. Para más información y ejemplos de código, vea RecurrencePattern y RecurrenceRule en la Referencia 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 horarios asociados, 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 solo una fecha de calendario y también define el tipo DATE‑TIME para identificar valores que especifican una fecha de calendario precisa y la hora del día. Los valores DATE‑TIME pueden especificarse en tres formas, con:

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

DATE

Según 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 la misma hora, minuto y segundo independientemente de la zona horaria que se esté observando.

DATE-TIME con hora UTC

La fecha con hora UTC, o tiempo absoluto, se identifica mediante un sufijo de la letra mayúscula latina Z, el designador UTC, añadido al valor de la hora. Por ejemplo, lo siguiente representa el 19 de enero de 1998 a las 07 00 UTC: DTSTART:19980119T070000Z Tenga en cuenta que Aspose iCalendar ignora el sufijo Z del formato UTC y trata la hora como hora local. El estándar RFC2445 indica que la parte de hora 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 la hora 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. Tenga en cuenta que Aspose iCalendar por el momento ignora el parámetro TZID y trata la hora como hora local.

BYWEEKNO proporciona cumplimiento ISO 8601

Usar BYWEEKNO solo cuando se requiera conformidad con ISO 8601 se requiere. Los números de semana definidos por 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 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 compatible con algunas aplicaciones bancarias y financieras europeas. También se utiliza en televisión para la reserva de comerciales. La regla BYWEEKNO especifica una lista de números separada por comas que identifican las semanas del año. Los valores válidos son de 1 a 53 y de 1 a 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.

Soporte para establecer Locale para el hilo actual Analizar archivos de mensajes de Microsoft Outlook