Office.SeriesTime interface

Package:

outlook

The SeriesTime object provides methods to get and set the dates and times of appointments in a recurring series and get the dates and times of meeting requests in a recurring series.

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

Methods

getDuration()	Gets the duration in minutes of a usual instance in a recurring appointment series.
getEndDate()	Gets the end date of a recurrence pattern in the following ISO 8601 date format: "YYYY-MM-DD".
getEndTime()	Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following ISO 8601 format: "THH:mm:ss:mmm".
getStartDate()	Gets the start date of a recurrence pattern in the following ISO 8601 date format: "YYYY-MM-DD".
getStartTime()	Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following ISO 8601 format: "THH:mm:ss:mmm".
setDuration(minutes)	Sets the duration of all appointments in a recurrence pattern. This will also change the end time of the recurrence pattern.
setEndDate(year, month, day)	Sets the end date of a recurring appointment series.
setEndDate(date)	Sets the end date of a recurring appointment series.
setStartDate(year, month, day)	Sets the start date of a recurring appointment series.
setStartDate(date)	Sets the start date of a recurring appointment series.
setStartTime(hours, minutes)	Sets the start time of all instances of a recurring appointment series in whichever time zone the recurrence pattern is set (the item's time zone is used by default).
setStartTime(time)	Sets the start time of all instances of a recurring appointment series in whichever time zone the recurrence pattern is set (the item's time zone is used by default).

Method Details

getDuration()

Gets the duration in minutes of a usual instance in a recurring appointment series.

getDuration(): number;

Returns

number

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

getEndDate()

Gets the end date of a recurrence pattern in the following ISO 8601 date format: "YYYY-MM-DD".

getEndDate(): string;

Returns

string

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

getEndTime()

Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following ISO 8601 format: "THH:mm:ss:mmm".

getEndTime(): string;

Returns

string

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

getStartDate()

Gets the start date of a recurrence pattern in the following ISO 8601 date format: "YYYY-MM-DD".

getStartDate(): string;

Returns

string

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

getStartTime()

Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following ISO 8601 format: "THH:mm:ss:mmm".

getStartTime(): string;

Returns

string

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read item

Applicable Outlook mode: Compose or Read

setDuration(minutes)

Sets the duration of all appointments in a recurrence pattern. This will also change the end time of the recurrence pattern.

setDuration(minutes: number): void;

Parameters

minutes

number

The length of the appointment in minutes.

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setEndDate(year, month, day)

Sets the end date of a recurring appointment series.

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

Parameters

year

number

The year value of the end date.

month

number

The month value of the end date. Valid range is 0-11 where 0 represents the 1st month and 11 represents the 12th month.

day

number

The day value of the end date.

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setEndDate(date)

Sets the end date of a recurring appointment series.

setEndDate(date: string): void;

Parameters

date

string

End date of the recurring appointment series represented in the ISO 8601 date format: "YYYY-MM-DD".

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setStartDate(year, month, day)

Sets the start date of a recurring appointment series.

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

Parameters

year

number

The year value of the start date.

month

number

The month value of the start date. Valid range is 0-11 where 0 represents the 1st month and 11 represents the 12th month.

day

number

The day value of the start date.

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setStartDate(date)

Sets the start date of a recurring appointment series.

setStartDate(date:string): void;

Parameters

date

string

Start date of the recurring appointment series represented in the ISO 8601 date format: "YYYY-MM-DD".

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setStartTime(hours, minutes)

Sets the start time of all instances of a recurring appointment series in whichever time zone the recurrence pattern is set (the item's time zone is used by default).

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

Parameters

hours

number

The hour value of the start time. Valid range: 0-24.

minutes

number

The minute value of the start time. Valid range: 0-59.

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose

setStartTime(time)

Sets the start time of all instances of a recurring appointment series in whichever time zone the recurrence pattern is set (the item's time zone is used by default).

setStartTime(time: string): void;

Parameters

time

string

Start time of all instances represented by standard datetime string format: "THH:mm:ss:mmm".

Returns

void

Remarks

[Api set: Mailbox 1.7]

Minimum permission level: read/write item

Applicable Outlook mode: Compose