Class: Time

Constructor

new Time(data, zone)

Creates a new ICAL.Time instance.

Parameters:

Name Type Description

data

Object

Time initialization

Properties

Name	Type	Attributes	Description
`year`	Number	<optional>	The year for this date
`month`	Number	<optional>	The month for this date
`day`	Number	<optional>	The day for this date
`hour`	Number	<optional>	The hour for this date
`minute`	Number	<optional>	The minute for this date
`second`	Number	<optional>	The second for this date
`isDate`	Boolean	<optional>	If true, the instance represents a date (as opposed to a date-time)

zone

ICAL.Timezone

timezone this position occurs in

Source: time.js, line 44

Example

var time = new ICAL.Time({
  year: 2012,
  month: 10,
  day: 11
  minute: 0,
  second: 0,
  isDate: false
});

Members

(constant) DEFAULT_WEEK_START

The default weekday for the WKST part.

Default Value: ICAL.Time.MONDAY
Source: time.js, line 381

daysInYearPassedMonth :Array.<Array.<Number>>

The days that have passed in the year after a given month. The array has two members, one being an array of passed days for non-leap years, the other analog for leap years.

Type:

Array.<Array.<Number>>

Source: time.js, line 363

Example

var isLeapYear = ICAL.Time.isLeapYear(year);
var passedDays = ICAL.Time.daysInYearPassedMonth[isLeapYear][month];

(constant) epochTime :ICAL.Time

January 1st, 1970 as an ICAL.Time.

Type:

ICAL.Time

Source: time.js, line 332

fromData

Creates a new ICAL.Time instance from the the passed data object.

Source: time.js, line 261

(constant) icalclass :String

The class identifier.

Type:

String

Default Value: "icaltime"
Source: time.js, line 419

icaltype :String

The type name, to be used in the jCal object. This value may change and is strictly defined by the isDate member.

Type:

String

Default Value: "date-time"
Source: time.js, line 428

zone :ICAL.Timezone

The timezone for this time.

Type:

ICAL.Timezone

Source: time.js, line 436

Methods

addDuration(aDuration)

Adds the duration to the current time. The instance is modified in place.

Parameters:

Name	Type	Description
`aDuration`	ICAL.Duration	The duration to add

Source: time.js, line 918

adjust(aExtraDays, aExtraHours, aExtraMinutes, aExtraSeconds, aTimeopt)

Adjust the date/time by the given offset

Parameters:

Name	Type	Attributes	Description
`aExtraDays`	Number		The extra amount of days
`aExtraHours`	Number		The extra amount of hours
`aExtraMinutes`	Number		The extra amount of minutes
`aExtraSeconds`	Number		The extra amount of seconds
`aTime`	Number	<optional>	The time to adjust, defaults to the current instance.

Source: time.js, line 1114

clone() → {ICAL.Time}

Returns a clone of the time object.

Source: time.js, line 453

Returns:

The cloned object

Type:: ICAL.Time

compare(aOther) → {Number}

Compares the ICAL.Time instance with another one.

Parameters:

Name	Type	Description
`aOther`	ICAL.Duration	The instance to compare with

Source: time.js, line 976

Returns:

-1, 0 or 1 for less/equal/greater

Type:: Number

compareDateOnlyTz(other, tz) → {Number}

Compares only the date part of this instance with another one.

Parameters:

Name	Type	Description
`other`	ICAL.Duration	The instance to compare with
`tz`	ICAL.Timezone	The timezone to compare in

Source: time.js, line 992

Returns:

-1, 0 or 1 for less/equal/greater

Type:: Number

convertToZone(zone) → {ICAL.Time}

Convert the instance into another timezone. The returned ICAL.Time instance is always a copy.

Parameters:

Name	Type	Description
`zone`	ICAL.Timezone	The zone to convert to

Source: time.js, line 1011

Returns:

The copy, converted to the zone

Type:: ICAL.Time

dayOfWeek(aWeekStartopt) → {ICAL.Time.weekDay}

Calculate the day of week.

Parameters:

Name	Type	Attributes	Description
`aWeekStart`	ICAL.Time.weekDay	<optional>	The week start weekday, defaults to SUNDAY

Source: time.js, line 579

Returns:

Type:: ICAL.Time.weekDay

dayOfYear() → {Number}

Calculate the day of year.

Source: time.js, line 609

Returns:

Type:: Number

endOfMonth() → {ICAL.Time}

Returns a copy of the current date/time, shifted to the end of the month. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Source: time.js, line 679

Returns:

The end of the month (cloned)

Type:: ICAL.Time

endOfWeek(aWeekStartopt) → {ICAL.Time}

Returns a copy of the current date/time, shifted to the end of the week. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Parameters:

Name	Type	Attributes	Description
`aWeekStart`	ICAL.Time.weekDay	<optional>	The week start weekday, defaults to SUNDAY

Source: time.js, line 644

Returns:

The end of the week (cloned)

Type:: ICAL.Time

endOfYear() → {ICAL.Time}

Returns a copy of the current date/time, shifted to the end of the year. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Source: time.js, line 714

Returns:

The end of the year (cloned)

Type:: ICAL.Time

fromData(aData, aZoneopt)

Sets up the current instance using members from the passed data object.

Parameters:

Name Type Attributes Description

aData

Object

Time initialization

Properties

Name	Type	Attributes	Description
`year`	Number	<optional>	The year for this date
`month`	Number	<optional>	The month for this date
`day`	Number	<optional>	The day for this date
`hour`	Number	<optional>	The hour for this date
`minute`	Number	<optional>	The minute for this date
`second`	Number	<optional>	The second for this date
`isDate`	Boolean	<optional>	If true, the instance represents a date (as opposed to a date-time)

aZone

ICAL.Timezone

Timezone this position occurs in

Source: time.js, line 534

fromJSDate(aDatenullable, useUTCopt)

Set up the current instance from the Javascript date value.

Parameters:

Name	Type	Attributes	Default	Description
`aDate`	Date	<nullable>		The Javascript Date to read, or null to reset
`useUTC`	Boolean	<optional>	false	If true, the UTC values of the date will be used

Source: time.js, line 494

fromUnixTime(seconds)

Sets up the current instance from unix time, the number of seconds since January 1st, 1970.

Parameters:

Name	Type	Description
`seconds`	Number	The seconds to set up with

Source: time.js, line 1206

getDominicalLetter(yr) → {String}

Get the dominical letter for the current year. Letters range from A - G for common years, and AG to GF for leap years.

Parameters:

Name	Type	Description
`yr`	Number	The year to retrieve the letter for

Source: time.js, line 747

Returns:

The dominical letter.

Type:: String

isNthWeekDay(aDayOfWeek, aPos) → {Boolean}

Checks if current time is the nth weekday, relative to the current month. Will always return false when rule resolves outside of current month.

Parameters:

Name	Type	Description
`aDayOfWeek`	ICAL.Time.weekDay	Day of week to check
`aPos`	Number	Relative position

Source: time.js, line 847

Returns:

True, if it is the nth weekday

Type:: Boolean

nthWeekDay(aDayOfWeek, aPos) → {Number}

Finds the nthWeekDay relative to the current month (not day). The returned value is a day relative the month that this month belongs to so 1 would indicate the first of the month and 40 would indicate a day in the following month.

Parameters:

Name	Type	Description
`aDayOfWeek`	Number	Day of the week see the day name constants
`aPos`	Number	Nth occurrence of a given week day values of 1 and 0 both indicate the first weekday of that type. aPos may be either positive or negative

Source: time.js, line 765

Returns:

numeric value indicating a day relative to the current month of this time object

Type:: Number

reset()

Reset the time instance to epoch time

Source: time.js, line 460

resetTo(year, month, day, hour, minute, second, timezone)

Reset the time instance to the given date/time values.

Parameters:

Name	Type	Description
`year`	Number	The year to set
`month`	Number	The month to set
`day`	Number	The day to set
`hour`	Number	The hour to set
`minute`	Number	The minute to set
`second`	Number	The second to set
`timezone`	ICAL.Timezone	The timezone to set

Source: time.js, line 476

startDoyWeek(aFirstDayOfWeekopt) → {Number}

First calculates the start of the week, then returns the day of year for this date. If the day falls into the previous year, the day is zero or negative.

Parameters:

Name	Type	Attributes	Description
`aFirstDayOfWeek`	ICAL.Time.weekDay	<optional>	The week start weekday, defaults to SUNDAY

Source: time.js, line 733

Returns:

The calculated day of year

Type:: Number

startOfMonth() → {ICAL.Time}

Returns a copy of the current date/time, rewound to the start of the month. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Source: time.js, line 662

Returns:

The start of the month (cloned)

Type:: ICAL.Time

startOfWeek(aWeekStartopt) → {ICAL.Time}

Returns a copy of the current date/time, rewound to the start of the week. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Parameters:

Name	Type	Attributes	Description
`aWeekStart`	ICAL.Time.weekDay	<optional>	The week start weekday, defaults to SUNDAY

Source: time.js, line 624

Returns:

The start of the week (cloned)

Type:: ICAL.Time

startOfYear() → {ICAL.Time}

Returns a copy of the current date/time, rewound to the start of the year. The resulting ICAL.Time instance is of icaltype date, even if this is a date-time.

Source: time.js, line 696

Returns:

The start of the year (cloned)

Type:: ICAL.Time

subtractDate(aDate) → {ICAL.Duration}

Subtract the date details (excluding timezone). Useful for finding the relative difference between two time objects excluding their timezone differences.

Parameters:

Name	Type	Description
`aDate`	ICAL.Time	The date to subtract

Source: time.js, line 952

Returns:

The difference as a duration

Type:: ICAL.Duration

subtractDateTz(aDate) → {ICAL.Duration}

Subtract the date details, taking timezones into account.

Parameters:

Name	Type	Description
`aDate`	ICAL.Time	The date to subtract

Source: time.js, line 964

Returns:

The difference in duration

Type:: ICAL.Duration

toICALString() → {String}

Returns an RFC 5545 compliant ical representation of this object.

Source: time.js, line 1043

Returns:

ical date/date-time

Type:: String

toJSDate() → {Date}

Converts the current instance to a Javascript date

Source: time.js, line 1080

Returns:

Type:: Date

toJSON() → {Object}

Converts time to into Object which can be serialized then re-created using the constructor.

Source: time.js, line 1269

Returns:

Type:: Object

Example

// toJSON will automatically be called
var json = JSON.stringify(mytime);

var deserialized = JSON.parse(json);

var time = new ICAL.Time(deserialized);

toString() → {String}

The string representation of this date/time, in jCal form (including : and - separators).

Source: time.js, line 1058

Returns:

Type:: String

toUnixTime() → {Number}

Converts the current instance to seconds since January 1st 1970.

Source: time.js, line 1233

Returns:

Seconds since 1970

Type:: Number

utcOffset() → {Number}

Calculates the UTC offset of the current date/time in the timezone it is in.

Source: time.js, line 1029

Returns:

UTC offset in seconds

Type:: Number

weekNumber(aWeekStart) → {Number}

Calculates the ISO 8601 week number. The first week of a year is the week that contains the first Thursday. The year can have 53 weeks, if January 1st is a Friday.

Note there are regions where the first week of the year is the one that starts on January 1st, which may offset the week number. Also, if a different week start is specified, this will also affect the week number.

Parameters:

Name	Type	Description
`aWeekStart`	ICAL.Time.weekDay	The weekday the week starts with

Source: time.js, line 878
See: Time.weekOneStarts

Returns:

The ISO week number

Type:: Number

(static) daysInMonth(month, year) → {Number}

Returns the days in the given month

Parameters:

Name	Type	Description
`month`	Number	The month to check
`year`	Number	The year to check

Source: time.js, line 55

Returns:

The number of days in the month

Type:: Number

(static) fromDateString(aValue) → {ICAL.Time}

Returns a new ICAL.Time instance from a date string, e.g 2015-01-02.

Parameters:

Name	Type	Description
`aValue`	String	The string to create from

Source: time.js, line 148

Returns:

The date/time instance

Type:: ICAL.Time

(static) fromDateTimeString(aValue, propopt) → {ICAL.Time}

Returns a new ICAL.Time instance from a date-time string, e.g 2015-01-02T03:04:05. If a property is specified, the timezone is set up from the property's TZID parameter.

Parameters:

Name	Type	Attributes	Description
`aValue`	String		The string to create from
`prop`	ICAL.Property	<optional>	The property the date belongs to

Source: time.js, line 172

Returns:

The date/time instance

Type:: ICAL.Time

(static) fromDayOfYear(aDayOfYear, aYear) → {ICAL.Time}

Create a new ICAL.Time from the day of year and year. The date is returned in floating timezone.

Parameters:

Name	Type	Description
`aDayOfYear`	Number	The day of year
`aYear`	Number	The year to create the instance in

Source: time.js, line 92

Returns:

The created instance with the calculated date

Type:: ICAL.Time

(static) fromJSDate(aDatenullable, useUTCopt)

Creates a new ICAL.Time instance from the given Javascript Date.

Parameters:

Name	Type	Attributes	Default	Description
`aDate`	Date	<nullable>		The Javascript Date to read, or null to reset
`useUTC`	Boolean	<optional>	false	If true, the UTC values of the date will be used

Source: time.js, line 242

(static) fromString(aValue, propopt) → {ICAL.Time}

Returns a new ICAL.Time instance from a date or date-time string,

Parameters:

Name	Type	Attributes	Description
`aValue`	String		The string to create from
`prop`	ICAL.Property	<optional>	The property the date belongs to

Source: time.js, line 228

Returns:

The date/time instance

Type:: ICAL.Time

(static) fromStringv2(str) → {ICAL.Time}

Returns a new ICAL.Time instance from a date string, e.g 2015-01-02.

Parameters:

Name	Type	Description
`str`	String	The string to create from

Deprecated: Use ICAL.Time.fromDateString instead
Source: time.js, line 133

Returns:

The date/time instance

Type:: ICAL.Time

(static) getDominicalLetter(yr) → {String}

Get the dominical letter for the given year. Letters range from A - G for common years, and AG to GF for leap years.

Parameters:

Name	Type	Description
`yr`	Number	The year to retrieve the letter for

Source: time.js, line 314

Returns:

The dominical letter.

Type:: String

(static) isLeapYear(year) → {Boolean}

Checks if the year is a leap year

Parameters:

Name	Type	Description
`year`	Number	The year to check

Source: time.js, line 76

Returns:

True, if the year is a leap year

Type:: Boolean

(static) now() → {ICAL.Time}

Creates a new ICAL.Time instance from the current moment. The instance is “floating” - has no timezone relation. To create an instance considering the time zone, call ICAL.Time.fromJSDate(new Date(), true)

Source: time.js, line 273

Returns:

Type:: ICAL.Time

(static) weekOneStarts(aYear, aWeekStartopt) → {ICAL.Time}

Returns the date on which ISO week number 1 starts.

Parameters:

Name	Type	Attributes	Description
`aYear`	Number		The year to search in
`aWeekStart`	ICAL.Time.weekDay	<optional>	The week start weekday, used for calculation.

Source: time.js, line 285
See: Time#weekNumber

Returns:

The date on which week number 1 starts

Type:: ICAL.Time

Type Definitions

weekDay

The weekday, 1 = SUNDAY, 7 = SATURDAY. Access via ICAL.Time.MONDAY, ICAL.Time.TUESDAY, ...

Type:

Number

Source: types.js, line 16