NSTimeZone
NSTimeZone
абстрактный класс, определяющий поведение объектов часового пояса. Объекты часового пояса представляют геополитические области. Следовательно, эти объекты имеют имена для этих областей. Объекты часового пояса также представляют временное смещение, или плюс или минус, со Среднего времени по Гринвичу (GMT) и сокращения (такого как PST для Тихоокеанского времени).
NSTimeZone
обеспечивает несколько методов класса получить объекты часового пояса: timeZoneWithName:
, timeZoneWithName:data:
, timeZoneWithAbbreviation:
, и timeZoneForSecondsFromGMT:
. Класс также разрешает Вам устанавливать часовой пояс по умолчанию в своем приложении (setDefaultTimeZone:
). Можно получить доступ к этому часовому поясу по умолчанию в любое время с defaultTimeZone
метод класса, и с localTimeZone
метод класса, можно получить относительный объект часового пояса, декодирующий себя для становления часовым поясом по умолчанию для любой локали, в которой это оказывается.
Обратите внимание на то, что, строго, записями базы данных часового пояса, такими как «America/Los_Angeles» является IDs не имена. Примером имени часового пояса является “Тихоокеанское Летнее время”. Несмотря на то, что многие NSTimeZone
имена методов включают слово «имя», они обращаются к IDs.
Какао не обеспечивает API для изменения часового пояса компьютера, или других приложений.
NSTimeZone
“бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFTimeZoneRef
. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSCopying
-
NSObjectProtocol
-
NSSecureCoding
-
Печатаемый
-
NSCopying
-
NSObject
-
NSSecureCoding
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает объект часового пояса, идентифицированный данным сокращением.
Объявление
Swift
convenience init?(abbreviation
abbreviation
: String)Objective C
+ (instancetype)timeZoneWithAbbreviation:(NSString *)
abbreviation
Параметры
abbreviation
Сокращение какое-то время зона.
Возвращаемое значение
Объект часового пояса, идентифицированный
abbreviation
определенный путем разрешения сокращения к имени с помощью словаря сокращения и затем возвращая часовой пояс для того имени. Возвратыnil
если там не идет ни в какое сравнение сabbreviation
.Обсуждение
В целом Вы отговорены использовать сокращения за исключением уникальных экземпляров, таких как «UTC» или «GMT». Сокращения Часового пояса не стандартизированы и таким образом, данное сокращение может иметь многозначности — например, «EST» относится к Восточному Времени и в США и в Австралии
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает объект часового пояса, идентифицированный данным ID.
Объявление
Objective C
+ (instancetype)timeZoneWithName:(NSString *)
tzName
Параметры
tzName
ID для часового пояса.
Возвращаемое значение
Часовой пояс в информационном каталоге с соответствием имени
tzName
. Возвратыnil
если там не идет ни в какое сравнение с именем.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает часовой пояс с данным ID, данные которого были инициализированы с помощью определенных данных,
Параметры
tzName
ID для часового пояса.
data
Данные от файлов часового пояса расположились в
/usr/share/zoneinfo
.Возвращаемое значение
Часовой пояс с ID
tzName
чьи данные были инициализированы с помощью содержанияdata
.Обсуждение
Вы не должны вызывать этот метод непосредственно — использование
timeZoneWithName:
для получения часового пояса возражают для имени.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает смещение объекта часового пояса со Среднего времени по Гринвичу данным числом секунд.
Объявление
Swift
convenience init(forSecondsFromGMT
seconds
: Int)Objective C
+ (instancetype)timeZoneForSecondsFromGMT:(NSInteger)
seconds
Параметры
seconds
Число секунд, к которым новый часовой пояс смещается от GMT.
Возвращаемое значение
Смещение объекта часового пояса со Среднего времени по Гринвичу
seconds
.Обсуждение
Именем нового часового пояса является GMT +/– смещение в часах и минутах. Часовые пояса, создаваемые с этим методом никогда, не имеют переход на летнее время, и смещение является постоянным независимо от того дата.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает часовой пояс, инициализированный с данным ID.
Объявление
Swift
init?(name
tzName
: String)Objective C
- (instancetype)initWithName:(NSString *)
tzName
Параметры
tzName
ID для часового пояса. Обеспечение
nil
поскольку этот параметр повышает исключение недействительного аргумента.Возвращаемое значение
Объект часового пояса инициализируется с ID
tzName
.Обсуждение
Если
tzName
известный ID, это вызовы методаinitWithName:data:
с надлежащим объектом данных.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Инициализирует часовой пояс с данным ID и данными часового пояса.
Объявление
Параметры
tzName
ID для часового пояса. Обеспечение
nil
поскольку этот параметр повышает исключение недействительного аргумента.data
Данные от файлов часового пояса расположились в
/usr/share/zoneinfo
.Обсуждение
Вы не должны вызывать этот метод непосредственно — использование
initWithName:
получить объект часового пояса.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает версию данных часового пояса.
Объявление
Swift
class func timeZoneDataVersion() -> String
Objective C
+ (NSString *)timeZoneDataVersion
Возвращаемое значение
Строка, содержащая версию данных часового пояса.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.
Возвращаемое значение
Объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.
Обсуждение
Зона местного времени представляет текущее состояние часового пояса по умолчанию в любом случае. Если Вы получаете часовой пояс по умолчанию (использование
defaultTimeZone
) и содержите на возвращенный объект, он не изменяется если последующий вызовsetDefaultTimeZone:
изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Зона местного времени добавляет уровень абстракции, она действует, как будто это был текущий часовой пояс по умолчанию каждый раз, когда Вы вызываете метод на нее.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает часовой пояс по умолчанию для текущего приложения.
Объявление
Swift
class func defaultTimeZone() -> NSTimeZone
Objective C
+ (NSTimeZone *)defaultTimeZone
Возвращаемое значение
Часовой пояс по умолчанию для текущего приложения. Если никакой часовой пояс по умолчанию не был установлен, этот метод вызывает
systemTimeZone
и возвращает зону системного времени.Обсуждение
Часовой пояс по умолчанию является тем, с которым работает приложение, который можно изменить (таким образом, можно сделать выполнение приложения, как будто это было в различном часовом поясе).
Если Вы получаете часовой пояс по умолчанию и содержите на возвращенный объект, он не изменяется если последующий вызов
setDefaultTimeZone:
изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Контрастируйте это поведение с объектом, возвращеннымlocalTimeZone
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает часовой пояс по умолчанию для текущего приложения к данному часовому поясу.
Объявление
Swift
class func setDefaultTimeZone(_
aTimeZone
: NSTimeZone)Objective C
+ (void)setDefaultTimeZone:(NSTimeZone *)
aTimeZone
Параметры
aTimeZone
Новый часовой пояс по умолчанию для текущего приложения.
Обсуждение
Может быть только один часовой пояс по умолчанию, таким образом, путем установки нового часового пояса по умолчанию, Вы теряете предыдущий.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Сбрасывает объект зоны системного времени, кэшируемый приложением, если таковые имеются.
Объявление
Swift
class func resetSystemTimeZone()
Objective C
+ (void)resetSystemTimeZone
Обсуждение
Если приложение кэшировало зону системного времени, этот метод очищает тот кэшируемый объект. Если Вы впоследствии вызываете
systemTimeZone
,NSTimeZone
попытается повторно определить зону системного времени, и новый объект будет создаваться и кэшироваться (см.systemTimeZone
).Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает часовой пояс, в настоящее время используемый системой.
Объявление
Swift
class func systemTimeZone() -> NSTimeZone
Objective C
+ (NSTimeZone *)systemTimeZone
Возвращаемое значение
Часовой пояс в настоящее время используется системой. Если зона текущего времени не может быть определена, возвращает часовой пояс GMT.
Специальные замечания
Если Вы получаете зону системного времени, она кэшируется приложением и не изменяется, если пользователь впоследствии изменяет зону системного времени. В следующий раз Вы вызываете
systemTimeZone
, Вы возвращаете тот же часовой пояс, который Вы первоначально получили. Необходимо вызватьresetSystemTimeZone
очистить кэшируемый объект.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает словарь, содержащий отображения сокращений часового пояса к именам часового пояса.
Объявление
Swift
class func abbreviationDictionary() -> [NSObject : AnyObject]
Objective C
+ (NSDictionary *)abbreviationDictionary
Возвращаемое значение
Словарь, содержащий отображения сокращений часового пояса к именам часового пояса.
Обсуждение
Обратите внимание на то, что больше чем один часовой пояс может иметь то же сокращение — например, США/Тихий океан и Канада/Тихий океан оба используют сокращение «PST». В этих случаях,
abbreviationDictionary
выбирает единственное имя для отображения сокращения на.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает массив строк, перечисляющих IDs все время зон, известных системе.
Объявление
Swift
class func knownTimeZoneNames() -> [AnyObject]
Objective C
+ (NSArray *)knownTimeZoneNames
Возвращаемое значение
Массив строк, перечисляющих IDs все время зон, известных системе.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает словарь сокращения в указанный словарь.
Объявление
Swift
class func setAbbreviationDictionary(_
dict
: [NSObject : AnyObject])Objective C
+ (void)setAbbreviationDictionary:(NSDictionary *)
dict
Параметры
dict
Словарь, содержащий пары ключ/значение для поиска часового пояса, называет данным их сокращения. Ключи должны быть
NSString
объекты, содержащие сокращения; значения должны бытьNSString
объекты, содержащие их соответствующие геополитические имена области.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.6 и позже.
-
сокращение сокращение
СвойствоСокращение для получателя, такого как «EDT» (Восточное поясное время). (только для чтения)
Объявление
Swift
var abbreviation: String? { get }
Objective C
@property(readonly, copy) NSString *abbreviation
Обсуждение
Вызывает
abbreviationForDate:
с текущей датой как параметр.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает сокращение для получателя в данной дате.
Объявление
Параметры
aDate
Дата, для которой можно получить сокращение для получателя.
Возвращаемое значение
Сокращение для получателя в
aDate
.Обсуждение
Обратите внимание на то, что сокращение может отличаться в различных датах. Например, в течение летнего времени часовой пояс США / Восточный часовой пояс имеют сокращение «EDT». В других случаях его сокращением является «EST».
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
secondsFromGMT secondsFromGMT
СвойствоТекущее различие в секундах между получателем и Среднее время по Гринвичу. (только для чтения)
Объявление
Swift
var secondsFromGMT: Int { get }
Objective C
@property(readonly) NSInteger secondsFromGMT
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает различие в секундах между получателем и Среднее время по Гринвичу в данной дате.
Объявление
Параметры
aDate
Дата, против которой можно протестировать получатель.
Возвращаемое значение
Различие в секундах между получателем и Среднее время по Гринвичу в
aDate
.Обсуждение
Если часовой пояс изменяет свое смещение от GMT в различных точках в году — например, изменение часовых поясов США с летним временем, различие может отличаться от текущего различия.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Данные, хранящие информацию, используемую получателем. (только для чтения)
Объявление
Swift
@NSCopying var data: NSData { get }
Objective C
@property(readonly, copy) NSData *data
Обсуждение
Эти данные должны быть обработаны как непрозрачный объект.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, имеет ли получатель то же имя и данные как зона требуемого времени.
Объявление
Swift
func isEqualToTimeZone(_
aTimeZone
: NSTimeZone) -> BoolObjective C
- (BOOL)isEqualToTimeZone:(NSTimeZone *)
aTimeZone
Параметры
aTimeZone
Часовой пояс для сравнения получателю.
Возвращаемое значение
YES
true
еслиaTimeZone
и получатель имеет то же имя и данные, иначеNO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Описание получателя, включая имя, сокращение, смещенное от GMT, и является ли летнее время в настоящее время в действительности. (только для чтения)
Объявление
Swift
var description: String { get }
Objective C
@property(readonly, copy) NSString *description
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает имя получателя, локализованного для данной локали.
Объявление
Swift
func localizedName(_
style
: NSTimeZoneNameStyle, localelocale
: NSLocale?) -> String?Objective C
- (NSString *)localizedName:(NSTimeZoneNameStyle)
style
locale:(NSLocale *)locale
Параметры
style
Стиль форматирования для возвращаемой строки.
locale
Локаль, для которой можно отформатировать имя.
Возвращаемое значение
Имя получателя, локализованного для
locale
использованиеstyle
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
daylightSavingTime daylightSavingTime
СвойствоБулево значение, указывающее, использует ли получатель в настоящее время летнее время. (только для чтения)
Объявление
Swift
var daylightSavingTime: Bool { get }
Objective C
@property(readonly, getter=isDaylightSavingTime) BOOL daylightSavingTime
Обсуждение
Если
YES
true
, получатель в настоящее время использует летнее время, иначеNO
false
. Это свойство вызываетisDaylightSavingTimeForDate:
с текущей датой как параметр.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.10 и позже.
-
Текущее смещение летнего времени получателя. (только для чтения)
Объявление
Swift
var daylightSavingTimeOffset: NSTimeInterval { get }
Objective C
@property(readonly) NSTimeInterval daylightSavingTimeOffset
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает булево значение, указывающее, использует ли получатель летнее время в данной дате.
Объявление
Swift
func isDaylightSavingTimeForDate(_
aDate
: NSDate) -> BoolObjective C
- (BOOL)isDaylightSavingTimeForDate:(NSDate *)
aDate
Параметры
aDate
Дата, против которой можно протестировать получатель.
Возвращаемое значение
YES
true
если получатель использует летнее время вaDate
, иначеNO
false
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает смещение летнего времени для данной даты.
Объявление
Swift
func daylightSavingTimeOffsetForDate(_
aDate
: NSDate) -> NSTimeIntervalObjective C
- (NSTimeInterval)daylightSavingTimeOffsetForDate:(NSDate *)
aDate
Параметры
aDate
Дата.
Возвращаемое значение
Смещение летнего времени для
aDate
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Дата следующего раза переход для получателя.
Объявление
Swift
@NSCopying var nextDaylightSavingTimeTransition: NSDate? { get }
Objective C
@property(readonly, copy) NSDate *nextDaylightSavingTimeTransition
Обсуждение
Это свойство содержит дату следующего (после текущего момента) переход летнего времени для получателя. В зависимости от часового пояса получателя значение этого свойства может представлять изменение смещения часового пояса от GMT.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Возвращает в следующий раз переход после данной даты.
Объявление
Параметры
aDate
Дата.
Возвращаемое значение
В следующий раз переход после
aDate
. В зависимости от часового пояса получателя этот метод может возвратить изменение смещения часового пояса от GMT.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
Укажите стили для представления имен часового пояса.
Объявление
Swift
enum NSTimeZoneNameStyle : Int { case Standard case ShortStandard case DaylightSaving case ShortDaylightSaving case Generic case ShortGeneric }
Objective C
typedef enum : NSInteger { NSTimeZoneNameStyleStandard, NSTimeZoneNameStyleShortStandard, NSTimeZoneNameStyleDaylightSaving, NSTimeZoneNameStyleShortDaylightSaving, NSTimeZoneNameStyleGeneric, NSTimeZoneNameStyleShortGeneric } NSTimeZoneNameStyle;
Константы
-
Standard
NSTimeZoneNameStyleStandard
Указывает стиль стандартного имени. Например, “Центральное Стандартное Время” для центрального поясного времени.
Доступный в OS X v10.5 и позже.
-
ShortStandard
NSTimeZoneNameStyleShortStandard
Указывает стиль краткого названия. Например, «CST» для центрального поясного времени.
Доступный в OS X v10.5 и позже.
-
DaylightSaving
NSTimeZoneNameStyleDaylightSaving
Указывает стиль имени перехода на летнее время. Например, “Центральное Летнее время” для центрального поясного времени.
Доступный в OS X v10.5 и позже.
-
ShortDaylightSaving
NSTimeZoneNameStyleShortDaylightSaving
Указывает короткий стиль имени перехода на летнее время. Например, «CDT» для центрального поясного времени.
Доступный в OS X v10.5 и позже.
-
Generic
NSTimeZoneNameStyleGeneric
Указывает стиль родового названия. Например, «центральное поясное время» для центрального поясного времени.
Доступный в OS X v10.6 и позже.
-
ShortGeneric
NSTimeZoneNameStyleShortGeneric
Указывает универсальное имя часового пояса. Например, «CT» для центрального поясного времени.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.
-
-
Отправленный, когда изменился часовой пояс.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.5 и позже.