Class ISN_NSTimeZone
Information about standard time conventions associated with a specific geopolitical region.
Time zones represent the standard time policies for a geopolitical region. Time zones have identifiers like “America/Los_Angeles” and can also be identified by abbreviations, such as PST for Pacific Standard Time.
Inheritance
Inherited Members
Namespace: SA.iOS.Foundation
Assembly: cs.temp.dll.dll
Syntax
public class ISN_NSTimeZone
Properties
DefaultTimeZone
The default time zone for the current app.
If no DefaultTimeZone time zone has been set, the current system time zone is used. If the current system time zone cannot be determined, the GMT time zone is used instead.
The DefaultTimeZone time zone is used by the app for date and time operations. You can set it to cause the app to run as if it were in a different time zone. Setting the DefaultTimeZone property clears any value that was previously set.
If you access the DefaultTimeZone class property, assign its value to a variable, and set a new defaultTimeZone time zone, the object stored in the variable doesn't update to reflect the new defaultTimeZone time zone. Contrast this behavior with that of the localTimeZone class property, which returns a proxy object that always reflects the current system time zone.
Declaration
public static ISN_NSTimeZone DefaultTimeZone { get; }
Property Value
Type | Description |
---|---|
ISN_NSTimeZone |
Description
A textual description of the time zone including the name, abbreviation, offset from GMT, and whether or not daylight saving time is currently in effect.
Declaration
public string Description { get; }
Property Value
Type | Description |
---|---|
System.String |
LocalTimeZone
Gets the local time zone.
If the current system time zone cannot be determined, the GMT time zone is used instead.
If you access the SystemTimeZone class property, its value is cached by the app and doesn't update if the user subsequently changes the system time zone. In order for the systemTimeZone property to reflect the new time zone, you must first call the ResetSystemTimeZone() method to clear the cached value. Then, the next time you access the SystemTimeZone property, it returns the current system time zone, and caches that value.
If you access the SystemTimeZone class property, assign its value to a variable, and clear the cached value for the property by calling the ResetSystemTimeZone() method, the object stored in the variable doesn't update to reflect the new system time zone. Contrast this behavior with that of the LocalTimeZone class property, which returns a proxy object that always reflects the current system time zone.
Declaration
public static ISN_NSTimeZone LocalTimeZone { get; }
Property Value
Type | Description |
---|---|
ISN_NSTimeZone |
Name
The geopolitical region ID that identifies the receiver.
Declaration
public string Name { get; }
Property Value
Type | Description |
---|---|
System.String |
SecondsFromGmt
The current difference in seconds between the receiver and Greenwich Mean Time.
Declaration
public int SecondsFromGmt { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
SecondsFromGMT
Declaration
public int SecondsFromGMT { get; }
Property Value
Type | Description |
---|---|
System.Int32 |
SystemTimeZone
Gets the local time zone.
If the current system time zone cannot be determined, the GMT time zone is used instead.
If you access the SystemTimeZone class property, its value is cached by the app and doesn't update if the user subsequently changes the system time zone. In order for the systemTimeZone property to reflect the new time zone, you must first call the ResetSystemTimeZone() method to clear the cached value. Then, the next time you access the SystemTimeZone property, it returns the current system time zone, and caches that value.
If you access the SystemTimeZone class property, assign its value to a variable, and clear the cached value for the property by calling the ResetSystemTimeZone() method, the object stored in the variable doesn't update to reflect the new system time zone. Contrast this behavior with that of the LocalTimeZone class property, which returns a proxy object that always reflects the current system time zone.
Declaration
public static ISN_NSTimeZone SystemTimeZone { get; }
Property Value
Type | Description |
---|---|
ISN_NSTimeZone |
Methods
ResetSystemTimeZone()
Clears any time zone value cached for the systemTimeZone property.
If the app has cached the system time zone by accessing the SystemTimeZone class property, this method clears that cached value. If you subsequently access the SystemTimeZone class property, a new time zone object is created and cached.
Declaration
public static void ResetSystemTimeZone()