# Managed Object - HostDateTimeSystem(vim.host.DateTimeSystem)

Property of
  HostConfigManager
See also
  HostDateTimeConfig, HostDateTimeInfo, HostDateTimeSystemTimeZone
Since
  VI API 2.5

## Managed Object Description

This managed object provides for NTP and date/time related configuration on a host. Information regarding the running status of the NTP daemon and functionality to start and stop the daemon is provided by the HostServiceSystem object.

Properties

Name | Type | Description
--- | --- | ---
dateTimeInfo P | HostDateTimeInfo | The DateTime configuration of the host.

P Required privilege: System.Read

Methods

Methods defined in this Managed Object
QueryAvailableTimeZones, QueryDateTime, RefreshDateTimeSystem, UpdateDateTime, UpdateDateTimeConfig

# QueryAvailableTimeZones(queryAvailableTimeZones)

Retrieves the list of available timezones on the host. The API works off the public domain 'tz' timezone database.

Required Privileges
  System.Read

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostDateTimeSystem used to make the method call.

Return Value

Type | Description
--- | ---
HostDateTimeSystemTimeZone[] | List of available timezones on the host.

Faults

Type | Description
--- | ---
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="QueryAvailableTimeZones" type="sms:QueryAvailableTimeZonesRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="QueryAvailableTimeZonesResponse"> <complexType> <sequence> <element name="returnval" type="sms:HostDateTimeSystemTimeZone" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# QueryDateTime(queryDateTime)

Get the current DateTime on the host.

Required Privileges
  System.Read

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostDateTimeSystem used to make the method call.

Return Value

Type | Description
--- | ---
xsd:dateTime | Current DateTime on the host.

Faults

Type | Description
--- | ---
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="QueryDateTime" type="sms:QueryDateTimeRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="QueryDateTimeResponse"> <complexType> <sequence> <element name="returnval" type="xsd:dateTime"/> </sequence> </complexType> </element>

# RefreshDateTimeSystem(refresh)

Refresh the DateTime related settings to pick up any changes that might have occurred.

Required Privileges
  Host.Config.DateTime

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostDateTimeSystem used to make the method call.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RefreshDateTimeSystem" type="sms:RefreshDateTimeSystemRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RefreshDateTimeSystemResponse"> <complexType/> </element>

# UpdateDateTime(updateDateTime)

Update the date/time on the host. This method should be used with caution since network delays, execution delays can result in time skews.

Required Privileges
  Host.Config.DateTime

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostDateTimeSystem used to make the method call.
dateTime | xsd:dateTime | DateTime to update the host to.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
HostConfigFault | Thrown if an error occurs.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="UpdateDateTime" type="sms:UpdateDateTimeRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="UpdateDateTimeResponse"> <complexType/> </element>

# UpdateDateTimeConfig(updateConfig)

Update the DateTime configuration of the host.

Required Privileges
  Host.Config.DateTime

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the HostDateTimeSystem used to make the method call.
config | HostDateTimeConfig | The new DateTime configuration information.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
HostConfigFault | Thrown if an error occurs.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="UpdateDateTimeConfig" type="sms:UpdateDateTimeConfigRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="UpdateDateTimeConfigResponse"> <complexType/> </element>