Office.SeriesTime interface

Das SeriesTime -Objekt bietet Methoden zum Abrufen und Festlegen der Datums- und Uhrzeitangaben von Terminen in einer Serie sowie zum Abrufen der Datums- und Uhrzeitangaben von Besprechungsanfragen in einer Serie.

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Methoden

getDuration()

Ruft die Dauer einer üblichen Instanz in einer Terminserie in Minuten ab.

getEndDate()

Ruft das Enddatum eines Serienmusters im folgenden ISO 8601-Datumsformat ab: "JJJJ-MM-TT".

getEndTime()

Ruft die Endzeit einer üblichen Termin- oder Besprechungsanfrageinstanz eines Serienmusters ab, in der der Benutzer oder das Add-In das Serienmuster festgelegt hat, und verwendet dabei das folgende ISO 8601-Format : "THH:mm:ss:mmm".

getStartDate()

Ruft das Startdatum eines Serienmusters im folgenden ISO 8601-Datumsformat ab: "JJJJ-MM-TT".

getStartTime()

Ruft die Startzeit einer üblichen Termininstanz eines Serienmusters in der Zeitzone ab, in der der Benutzer bzw. das Add-In das Serienmuster im folgenden ISO 8601-Format festgelegt hat: "THH:mm:ss:mmm".

setDuration(minutes)

Legt die Dauer aller Termine in einem Serienmuster fest. Dadurch wird auch die Endzeit des Serienmusters geändert.

setEndDate(year, month, day)

Legt das Enddatum einer Terminserie fest.

setEndDate(date)

Legt das Enddatum einer Terminserie fest.

setStartDate(year, month, day)

Legt den Starttermin einer Terminserie fest.

setStartDate(date)

Legt den Starttermin einer Terminserie fest.

setStartTime(hours, minutes)

Legt die Startzeit aller Instanzen einer Terminserie in der Zeitzone fest, in der das Serienmuster festgelegt ist (standardmäßig wird die Zeitzone des Elements verwendet).

setStartTime(time)

Legt die Startzeit aller Instanzen einer Terminserie in der Zeitzone fest, in der das Serienmuster festgelegt ist (standardmäßig wird die Zeitzone des Elements verwendet).

Details zur Methode

getDuration()

Ruft die Dauer einer üblichen Instanz in einer Terminserie in Minuten ab.

getDuration(): number;

Gibt zurück

number

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// This example gets the duration of a usual instance in a recurring appointment series.
Office.context.mailbox.item.recurrence.getAsync(callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const recurrence = asyncResult.value;
    const duration = recurrence.seriesTime.getDuration();
}

getEndDate()

Ruft das Enddatum eines Serienmusters im folgenden ISO 8601-Datumsformat ab: "JJJJ-MM-TT".

getEndDate(): string;

Gibt zurück

string

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// This example gets the end date of a recurring appointment series.
Office.context.mailbox.item.recurrence.getAsync(callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const recurrence = asyncResult.value;
    const endDate = recurrence.seriesTime.getEndDate();
}

getEndTime()

Ruft die Endzeit einer üblichen Termin- oder Besprechungsanfrageinstanz eines Serienmusters ab, in der der Benutzer oder das Add-In das Serienmuster festgelegt hat, und verwendet dabei das folgende ISO 8601-Format : "THH:mm:ss:mmm".

getEndTime(): string;

Gibt zurück

string

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// This example gets the end time of a usual instance in a recurring appointment series.
Office.context.mailbox.item.recurrence.getAsync(callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const recurrence = asyncResult.value;
    const endDate = recurrence.seriesTime.getEndTime();
}

getStartDate()

Ruft das Startdatum eines Serienmusters im folgenden ISO 8601-Datumsformat ab: "JJJJ-MM-TT".

getStartDate(): string;

Gibt zurück

string

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// This example gets the start date of a recurring appointment series.
Office.context.mailbox.item.recurrence.getAsync(callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const recurrence = asyncResult.value;
    const endDate = recurrence.seriesTime.getStartDate();
}

getStartTime()

Ruft die Startzeit einer üblichen Termininstanz eines Serienmusters in der Zeitzone ab, in der der Benutzer bzw. das Add-In das Serienmuster im folgenden ISO 8601-Format festgelegt hat: "THH:mm:ss:mmm".

getStartTime(): string;

Gibt zurück

string

Hinweise

[ API-Satz: Postfach 1.7 ]

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// This example gets the start time of a usual
// instance in a recurring appointment series.
const seriesTimeObject = new SeriesTime();
seriesTimeObject.setDuration(120);

setDuration(minutes)

Legt die Dauer aller Termine in einem Serienmuster fest. Dadurch wird auch die Endzeit des Serienmusters geändert.

setDuration(minutes: number): void;

Parameter

minutes

number

Die Länge des Termins in Minuten.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the duration of each appointment
// in a recurring series to 2 hours.
Office.context.mailbox.item.recurrence.getAsync(callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const recurrence = asyncResult.value;
    const endDate = recurrence.seriesTime.getStartTime();
}

setEndDate(year, month, day)

Legt das Enddatum einer Terminserie fest.

setEndDate(year: number, month: number, day: number): void;

Parameter

year

number

Der Jahreswert des Enddatums.

month

number

Der Monatswert des Enddatums. Gültiger Bereich ist 0 bis 11, wobei 0 den 1. Monat und 11 den 12. Monat darstellt.

day

number

Der Tagwert des Enddatums.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the end date of a recurring
// appointment series to November 2, 2017.
const seriesTimeObject = new SeriesTime();
seriesTimeObject.setEndDate(2017, 10, 2);

setEndDate(date)

Legt das Enddatum einer Terminserie fest.

setEndDate(date: string): void;

Parameter

date

string

Enddatum der Terminserie, die im ISO 8601-Datumsformat dargestellt wird: "JJJJ-MM-TT".

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the end date of a
// recurring appointment series to November 2, 2017
// using ISO 8601 date standard.
const seriesTimeObject = new SeriesTime()
seriesTimeObject.setEndDate("2017-11-02");

setStartDate(year, month, day)

Legt den Starttermin einer Terminserie fest.

setStartDate(year:number, month:number, day:number): void;

Parameter

year

number

Der Jahreswert des Startdatums.

month

number

Der Monatswert des Startdatums. Gültiger Bereich ist 0 bis 11, wobei 0 den 1. Monat und 11 den 12. Monat darstellt.

day

number

Der Tagwert des Startdatums.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the start date of a recurring
// appointment series to November 2, 2017.
const seriesTimeObject = new SeriesTime();
seriesTimeObject.setStartDate(2017, 10, 2);

setStartDate(date)

Legt den Starttermin einer Terminserie fest.

setStartDate(date:string): void;

Parameter

date

string

Startdatum der Terminserie im ISO 8601-Datumsformat "JJJJ-MM-TT".

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the start date of a recurring
// appointment series to November 2, 2017
// using ISO 8601 date standard.
const seriesTimeObject = new SeriesTime()
seriesTimeObject.setStartDate("2017-11-02");

setStartTime(hours, minutes)

Legt die Startzeit aller Instanzen einer Terminserie in der Zeitzone fest, in der das Serienmuster festgelegt ist (standardmäßig wird die Zeitzone des Elements verwendet).

setStartTime(hours: number, minutes: number): void;

Parameter

hours

number

Der Stundenwert der Startzeit. Gültiger Bereich: 0-24.

minutes

number

Der Minutenwert der Startzeit. Gültiger Bereich: 0-59.

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the start time of each instance
// of a recurring appointment series to 1:30 PM.
const seriesTimeObject = new SeriesTime();
seriesTimeObject.setStartTime(13, 30);

// This example sets the start time of each instance
// of a recurring appointment series to 11:30 AM.
seriesTimeObject.setStartTime(11, 30);

setStartTime(time)

Legt die Startzeit aller Instanzen einer Terminserie in der Zeitzone fest, in der das Serienmuster festgelegt ist (standardmäßig wird die Zeitzone des Elements verwendet).

setStartTime(time: string): void;

Parameter

time

string

Startzeit aller Instanzen, die durch das standardmäßige datetime-Zeichenfolgenformat dargestellt werden: "THH:mm:ss:mmm".

Gibt zurück

void

Hinweise

[ API-Satz: Postfach 1.7 ]

Minimale Berechtigungsstufe: Element lesen/schreiben

Anwendbarer Outlook-Modus: Verfassen

Beispiele

// This example sets the start time of each instance
// of a recurring appointment series to 11:30 PM.
const seriesTimeObject = new SeriesTime()
seriesTimeObject.setStartTime("T23:30:00");