Office.Time interface
Das Time -Objekt wird als Start- oder Endeigenschaft eines Termins im Verfassenmodus zurückgegeben.
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen
Methoden
| get |
Ruft die Start- oder Endzeit eines Termins ab. Das Datum und die Uhrzeit werden als |
| get |
Ruft die Start- oder Endzeit eines Termins ab. Das Datum und die Uhrzeit werden als |
| set |
Legt die Start- oder Endzeit eines Termins fest. Wenn die Die Uhrzeit muss UTC-Format aufweisen; Sie können mithilfe der Wichtig: Im Windows-Client können Sie diese Methode nicht verwenden, um den Anfang oder das Ende einer Serie zu aktualisieren. |
| set |
Legt die Start- oder Endzeit eines Termins fest. Wenn die Die Uhrzeit muss UTC-Format aufweisen; Sie können mithilfe der Wichtig: Im Windows-Client können Sie diese Methode nicht verwenden, um den Anfang oder das Ende einer Serie zu aktualisieren. |
Details zur Methode
getAsync(options, callback)
Ruft die Start- oder Endzeit eines Termins ab.
Das Datum und die Uhrzeit werden als Date -Objekt in der asyncResult.value -Eigenschaft bereitgestellt. Der Wert wird in UTC (Coordinated Universal Time) angegeben. Sie können die UTC-Zeit mithilfe der -Methode in die convertToLocalClientTime lokale Clientzeit konvertieren.
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<Date>) => void): void;Parameter
- options
- Office.AsyncContextOptions
Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.
- callback
-
(asyncResult: Office.AsyncResult<Date>) => void
Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Die value -Eigenschaft des Ergebnisses ist ein Date -Objekt.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen
getAsync(callback)
Ruft die Start- oder Endzeit eines Termins ab.
Das Datum und die Uhrzeit werden als Date -Objekt in der asyncResult.value -Eigenschaft bereitgestellt. Der Wert wird in UTC (Coordinated Universal Time) angegeben. Sie können die UTC-Zeit mithilfe der -Methode in die convertToLocalClientTime lokale Clientzeit konvertieren.
getAsync(callback: (asyncResult: Office.AsyncResult<Date>) => void): void;Parameter
- callback
-
(asyncResult: Office.AsyncResult<Date>) => void
Wenn die Methode abgeschlossen ist, wird die im Rückrufparameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Die value -Eigenschaft des Ergebnisses ist ein Date -Objekt.
Gibt zurück
void
Hinweise
Mindestberechtigungsstufe: Element lesen
Anwendbarer Outlook-Modus: Verfassen
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-start-appointment-organizer.yaml
Office.context.mailbox.item.start.getAsync((result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Action failed with message ${result.error.message}`);
return;
}
console.log(`Appointment starts: ${result.value}`);
});
setAsync(dateTime, options, callback)
Legt die Start- oder Endzeit eines Termins fest.
Wenn die setAsync -Methode für die start-Eigenschaft aufgerufen wird, wird die end Eigenschaft so angepasst, dass die Dauer des Termins wie zuvor festgelegt beibehalten wird. Wenn die setAsync-Methode für die end-Eigenschaft aufgerufen wird, wird die Dauer des Termins bis zur neuen Endzeit verlängert.
Die Uhrzeit muss UTC-Format aufweisen; Sie können mithilfe der convertToUtcClientTime-Methode die korrekte UTC-Uhrzeit abrufen.
Wichtig: Im Windows-Client können Sie diese Methode nicht verwenden, um den Anfang oder das Ende einer Serie zu aktualisieren.
setAsync(dateTime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- dateTime
-
Date
Ein Datum/Uhrzeitobjekt in koordinierter Weltzeit (UTC).
- options
- Office.AsyncContextOptions
Ein Objektliteral, das eine oder mehrere der folgenden Eigenschaften enthält: asyncContextEntwickler können jedes Objekt bereitstellen, auf das sie in der Rückruffunktion zugreifen möchten.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn das Festlegen von Datum und Uhrzeit fehlschlägt, enthält die asyncResult.error-Eigenschaft einen Fehlercode.
Gibt zurück
void
Hinweise
Minimale Berechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Verfassen
Fehler:
-
InvalidEndTime: Die Terminendzeit liegt vor der Startzeit des Termins.
Beispiele
const startTime = new Date("3/14/2015");
const options = {
// Pass information that can be used in the callback.
asyncContext: {verb: "Set"}
};
Office.context.mailbox.item.start.setAsync(startTime, options, function(result) {
if (result.error) {
console.debug(result.error);
} else {
// Access the asyncContext that was passed to the setAsync method.
console.debug("Start Time " + result.asyncContext.verb);
}
});
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-start-appointment-organizer.yaml
const start = new Date(); // Represents current date and time.
start.setDate(start.getDate() + 2); // Add 2 days to current date.
Office.context.mailbox.item.start.setAsync(start, (result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Action failed with message ${result.error.message}`);
return;
}
console.log(`Successfully set start date and time to ${start}`);
});
...
Office.context.mailbox.item.start.getAsync((result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Get start date failed with message ${result.error.message}`);
return;
}
const end = result.value; // Set end to current start date and time.
end.setDate(end.getDate() + 1); // Set end as 1 day later than start date.
Office.context.mailbox.item.end.setAsync(end, (result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Set end date failed with message ${result.error.message}`);
return;
}
console.log(`Successfully set end date and time to ${end}`);
});
});
setAsync(dateTime, callback)
Legt die Start- oder Endzeit eines Termins fest.
Wenn die setAsync -Methode für die start-Eigenschaft aufgerufen wird, wird die end Eigenschaft so angepasst, dass die Dauer des Termins wie zuvor festgelegt beibehalten wird. Wenn die setAsync-Methode für die end-Eigenschaft aufgerufen wird, wird die Dauer des Termins bis zur neuen Endzeit verlängert.
Die Uhrzeit muss UTC-Format aufweisen; Sie können mithilfe der convertToUtcClientTime-Methode die korrekte UTC-Uhrzeit abrufen.
Wichtig: Im Windows-Client können Sie diese Methode nicht verwenden, um den Anfang oder das Ende einer Serie zu aktualisieren.
setAsync(dateTime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;Parameter
- dateTime
-
Date
Ein Datum/Uhrzeitobjekt in koordinierter Weltzeit (UTC).
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Optional. Wenn die -Methode abgeschlossen ist, wird die im callback -Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResultaufgerufen. Wenn das Festlegen von Datum und Uhrzeit fehlschlägt, enthält die asyncResult.error-Eigenschaft einen Fehlercode.
Gibt zurück
void
Hinweise
Minimale Berechtigungsstufe: Element lesen/schreiben
Anwendbarer Outlook-Modus: Verfassen
Fehler:
-
InvalidEndTime: Die Terminendzeit liegt vor der Startzeit des Termins.
Office Add-ins