APIs in Category: clock | API version 1.8

clock-get-clock clock-get-timezone clock-set-clock clock-set-timezone | These APIs allow for manipulation of timezone and date on the filer. Timezone and date can be set on the filer as well as we can get the current date, timezone and compliance clock time on the filer.

NetApp Manage ONTAP

clock-get-clock | [top]

> gets current date and time from filer.

> Input Name | Range | Type | Description
> is-compliance-clock |  | boolean optional | If this is true, then clock for the compliance is returned, otherwise clock for local is returned. Default is false.
> Output Name | Range | Type | Description
> local-time | -43200..2^31-1 | integer | Local date and time of the filer in seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours.
> utc-time | 0..2^31-1 | integer | Current date and time of the filer in seconds since Midnight, 1/1/1970.

> Errno | Description
> EINTERNALERROR |  |
> ESNAPLOCKNOTLICENSED |  |
> ECOMPLIANCECLOCKNOTSET |  |

clock-get-timezone | [top]

> Gets current timezone and timezone file version.

> Output Name | Range | Type | Description
> timezone |  | string | Current timezone name where the storage system is operating. A timezone can have one of the two formats: "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone."; "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";
> timezone-UTC |  | string | Current timezone of the storage system in UTC +/-hhmm format. This indicates that the local time zone is hh hours and mm minutes ahead or behind UTC. For example, Central European Time(CET) is +0100 and U.S./Canadian Eastern Standard Time(EST) is -0500.
> timezone-version |  | string | Version of the time zone database. "YYYY" is the year the data base was released and "v" is the version within that year. "YYYY" will be four decimal digits and "v" will be an ASCII letter starting with "a" and increasing with each version. For example, the second 2007 version is "2007b".

> Errno | Description
> ENOTIMEZONESET |  |
> ENOTIMEZONEVERSION |  |

clock-set-clock | [top]

> Set current date and time to the specified date and time.

> Input Name | Range | Type | Description
> is-utc-clock |  | boolean | If this is true, then clock is given in UTC (universal time) instead of local time.
> time | -43200..2^31-1 | integer | Actual value of the date and time which has to be set as the current date and time on filer. Value will be seconds since Midnight, 1/1/1970. Depending on the time zone and clock settings, this might be negative by up to 12 hours.

> Errno | Description
> EINVALIDINPUTERROR |  |
> EINTERNALERROR |  |
> ETAKENOVER |  |
> EDATENOTSETONPARTNER |  |

clock-set-timezone | [top]

> Set current timezone to the specified timezone.

> Input Name | Range | Type | Description
> timezone |  | string | Name of the timezone value which has to be set as current timezone value. A timezone can have one of the two formats: "Using a location string specified in Arthur David Olsen's public domain time zone database. For example, "Americas/New_York" represents most of the Eastern Time Zone."; "A traditional time zone abbreviation incorporating default rules for daylight savings time. For example, "EST5EDT" for the US Eastern Time Zone.";

> Errno | Description
> EINVALIDTIMEZONE |  |
> ETIMEZONEDIFFERENTINRC |  |