Belangrijke iCalendar RFC 2445‑details

Over het Aspose iCalendar‑objectmodel

Aspose.Email bevat alle klassen die door Aspose worden geleverd iCalendar component RecurrencePattern en RecurrenceRule zijn de centrale klassen van Aspose iCalendar, en concrete implementaties geven van de overeenkomstige RFC‑2445‑elementen.

De RecurrencePattern klasse vertegenwoordigt het volledige terugkeer‑patroon. U kunt een nieuw terugkeer‑patroon vanaf nul maken met de standaardconstructor of een bestaand patroon laden in CalendarRecurrence. De RecurrenceRule klasse vertegenwoordigt het RRULE‑ of EXRULE‑deel van een terugkeer‑patroon. RecurrenceRule maakt een aantal eigenschappen beschikbaar die direct overeenkomen met hun tegenhangers in de iCalendar‑standaard. Bijvoorbeeld, ByMonth correspondeert met BYMONTH in iCalendar, enzovoort. Door de waarden van de RecurrenceRule eigenschappen waarmee u een terugkeer­regel kunt analyseren of wijzigen. Voor meer informatie en code‑voorbeelden, zie RecurrencePattern en RecurrenceRule in de API‑referentie.

Belangrijke iCalendar RFC 2445‑details

Deze sectie bevat de volgende onderwerpen:

  • Datum‑ en tijdformaten.
  • DATUM.
  • DATUM‑TIJD met lokale tijd.
  • DATUM‑TIJD met UTC‑tijd.
  • DATUM‑TIJD met lokale tijd en tijdzone.
  • BYWEEKNO biedt ISO 8601‑naleving

Datum‑ en tijdformaten

Datums, of datums met bijbehorende tijden, kunnen worden gebruikt in de DTSTART, UNTIL, EXDATE en RDATE‑elementen bij het specificeren van een terugkeerpatroon. iCalendar definieert het DATE‑valuetype om waarden te identificeren die een kalenderdatum bevatten en definieert ook het DATE‑TIME‑type om waarden te identificeren die een precieze kalenderdatum en tijd van de dag specificeren. DATE‑TIME‑waarden kunnen in drie vormen worden opgegeven, met:

  • Lokale tijd.
  • UTC‑tijd.
  • Lokale tijd en tijdzone.

DATUM

Volgens de iCalendar‑standaard moeten DATE‑waarden het formaat yyyyMMdd volgen. Het volgende voorbeeld vertegenwoordigt 14 juli 1997: 19970714

DATUM‑TIJD met lokale tijd

De datum met lokale tijd is eenvoudigweg een datum‑tijdwaarde die geen UTC‑aanduiding bevat en geen tijdzone referereert. Bijvoorbeeld, het volgende vertegenwoordigt 18 januari 1998 om 23 uur: DTSTART:19980118T230000. Datum‑tijdwaarden van dit type worden "zwevend" genoemd en zijn niet gebonden aan een specifieke tijdzone. Ze worden gebruikt om hetzelfde uur‑, minuut‑ en seconde‑waarde weer te geven, ongeacht welke tijdzone momenteel wordt toegepast.

DATUM‑TIJD met UTC‑tijd

De datum met UTC‑tijd, of absolute tijd, wordt aangeduid met een hoofdletter Z‑achtervoegsel, de UTC‑aanduiding, die aan de tijdwaarde wordt toegevoegd. Bijvoorbeeld, het volgende vertegenwoordigt 19 januari 1998 om 07 00 UTC: DTSTART:19980119T070000Z Let op dat Aspose iCalendar negeert het UTC‑formaat Z‑achtervoegsel en behandelt de tijd als lokale tijd. De RFC2445‑standaard stelt dat een tijdsegment gespecificeerd in de UNTIL‑regel van een terugkeerpatroon in UTC‑formaat moet zijn. Dit is een zeer vreemde bewering, en in feite zijn er voorbeelden in de standaard die onjuist zijn berekend. Aspose iCalendar accepteert tijd in elk formaat in de UNTIL‑regel.

DATUM‑TIJD met lokale tijd en tijdzone

Om de tijdzone te refereren, wordt DATE‑TIME aangepast met de TZID‑eigenschap. Bijvoorbeeld, het volgende vertegenwoordigt 2 uur ’s ochtends in New York op 19 januari 1998: DTSTART;TZID=US-Eastern:19980119T020000. Let op dat Aspose iCalendar negeert op dit moment de TZID‑parameter en behandelt de tijd als lokale tijd.

BYWEEKNO biedt ISO 8601‑naleving

Gebruik BYWEEKNO alleen wanneer conformiteit met ISO 8601 is vereist. Weeknummers zoals gedefinieerd door ISO 8601 verschillen sterk van weeknummers in de gewone zin. Volgens ISO 8601 is weeknummer één van het kalenderjaar de eerste week van een kalenderjaar die minstens vier dagen bevat. Deze regel maakt het algoritme specifiek voor applicaties die conformiteit aan ISO 8601 vereisen en maakt het bijna onbruikbaar voor andere toepassingen. ISO 8601 wordt ondersteund door sommige Europese bank‑ en financiële applicaties. Het wordt ook in de televisie gebruikt voor het boeken van reclames. De BYWEEKNO‑regel specificeert een door komma’s gescheiden lijst van getallen die weken van het jaar identificeren. Geldige waarden zijn 1 tot 53 en 1 tot 53. Dit komt overeen met weken volgens de weeknummering zoals gedefinieerd in ISO 8601. BYWEEKNO is alleen geldig voor JARLIJKSE regels.

Ondersteuning voor het instellen van Locale voor de huidige thread Microsoft Outlook‑berichtbestanden parseren