NSTimeZone
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCoding -
NSCopying -
NSObjectProtocol -
NSSecureCoding -
Печатаемый -
NSCopying -
NSObject -
NSSecureCoding
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в iOS 2.0 и позже.
NSTimeZone абстрактный класс, определяющий поведение объектов часового пояса. Объекты часового пояса представляют геополитические области. Следовательно, эти объекты имеют имена для этих областей. Объекты часового пояса также представляют временное смещение, или плюс или минус, со Среднего времени по Гринвичу (GMT) и сокращения (такого как PST для Тихоокеанского времени).
NSTimeZone обеспечивает несколько методов класса получить объекты часового пояса: timeZoneWithName:, timeZoneWithName:data:, timeZoneWithAbbreviation:, и timeZoneForSecondsFromGMT:. Класс также разрешает Вам устанавливать часовой пояс по умолчанию в своем приложении (setDefaultTimeZone:). Можно получить доступ к этому часовому поясу по умолчанию в любое время с defaultTimeZone метод класса, и с localTimeZone метод класса, можно получить относительный объект часового пояса, декодирующий себя для становления часовым поясом по умолчанию для любой локали, в которой это оказывается.
Обратите внимание на то, что, строго, записями базы данных часового пояса, такими как «America/Los_Angeles» является IDs не имена. Примером имени часового пояса является “Тихоокеанское Летнее время”. Несмотря на то, что многие NSTimeZone имена методов включают слово «имя», они обращаются к IDs.
Какао не обеспечивает API для изменения часового пояса компьютера, или других приложений.
NSTimeZone “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFTimeZoneRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.
-
Возвращает объект часового пояса, идентифицированный данным сокращением.
Объявление
Swift
convenience init?(abbreviationabbreviation: String)Objective C
+ (instancetype)timeZoneWithAbbreviation:(NSString *)abbreviationПараметры
abbreviationСокращение какое-то время зона.
Возвращаемое значение
Объект часового пояса, идентифицированный
abbreviationопределенный путем разрешения сокращения к имени с помощью словаря сокращения и затем возвращая часовой пояс для того имени. Возвратыnilесли там не идет ни в какое сравнение сabbreviation.Обсуждение
В целом Вы отговорены использовать сокращения за исключением уникальных экземпляров, таких как «UTC» или «GMT». Сокращения Часового пояса не стандартизированы и таким образом, данное сокращение может иметь многозначности — например, «EST» относится к Восточному Времени и в США и в Австралии
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает объект часового пояса, идентифицированный данным ID.
Объявление
Objective C
+ (instancetype)timeZoneWithName:(NSString *)tzNameПараметры
tzNameID для часового пояса.
Возвращаемое значение
Часовой пояс в информационном каталоге с соответствием имени
tzName. Возвратыnilесли там не идет ни в какое сравнение с именем.Оператор импорта
Objective C
@import Foundation;Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает часовой пояс с данным ID, данные которого были инициализированы с помощью определенных данных,
Параметры
tzNameID для часового пояса.
dataДанные от файлов часового пояса расположились в
/usr/share/zoneinfo.Возвращаемое значение
Часовой пояс с ID
tzNameчьи данные были инициализированы с помощью содержанияdata.Обсуждение
Вы не должны вызывать этот метод непосредственно — использование
timeZoneWithName:для получения часового пояса возражают для имени.Оператор импорта
Objective C
@import Foundation;Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает смещение объекта часового пояса со Среднего времени по Гринвичу данным числом секунд.
Объявление
Swift
convenience init(forSecondsFromGMTseconds: Int)Objective C
+ (instancetype)timeZoneForSecondsFromGMT:(NSInteger)secondsПараметры
secondsЧисло секунд, к которым новый часовой пояс смещается от GMT.
Возвращаемое значение
Смещение объекта часового пояса со Среднего времени по Гринвичу
seconds.Обсуждение
Именем нового часового пояса является GMT +/– смещение в часах и минутах. Часовые пояса, создаваемые с этим методом никогда, не имеют переход на летнее время, и смещение является постоянным независимо от того дата.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает часовой пояс, инициализированный с данным ID.
Объявление
Swift
init?(nametzName: String)Objective C
- (instancetype)initWithName:(NSString *)tzNameПараметры
tzNameID для часового пояса. Обеспечение
nilпоскольку этот параметр повышает исключение недействительного аргумента.Возвращаемое значение
Объект часового пояса инициализируется с ID
tzName.Обсуждение
Если
tzNameизвестный ID, это вызовы методаinitWithName:data:с надлежащим объектом данных.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Инициализирует часовой пояс с данным ID и данными часового пояса.
Объявление
Параметры
tzNameID для часового пояса. Обеспечение
nilпоскольку этот параметр повышает исключение недействительного аргумента.dataДанные от файлов часового пояса расположились в
/usr/share/zoneinfo.Обсуждение
Вы не должны вызывать этот метод непосредственно — использование
initWithName:получить объект часового пояса.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает версию данных часового пояса.
Объявление
Swift
class func timeZoneDataVersion() -> StringObjective C
+ (NSString *)timeZoneDataVersionВозвращаемое значение
Строка, содержащая версию данных часового пояса.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 4.0 и позже.
-
Возвращает объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.
Возвращаемое значение
Объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.
Обсуждение
Зона местного времени представляет текущее состояние часового пояса по умолчанию в любом случае. Если Вы получаете часовой пояс по умолчанию (использование
defaultTimeZone) и содержите на возвращенный объект, он не изменяется если последующий вызовsetDefaultTimeZone:изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Зона местного времени добавляет уровень абстракции, она действует, как будто это был текущий часовой пояс по умолчанию каждый раз, когда Вы вызываете метод на нее.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает часовой пояс по умолчанию для текущего приложения.
Объявление
Swift
class func defaultTimeZone() -> NSTimeZoneObjective C
+ (NSTimeZone *)defaultTimeZoneВозвращаемое значение
Часовой пояс по умолчанию для текущего приложения. Если никакой часовой пояс по умолчанию не был установлен, этот метод вызывает
systemTimeZoneи возвращает зону системного времени.Обсуждение
Часовой пояс по умолчанию является тем, с которым работает приложение, который можно изменить (таким образом, можно сделать выполнение приложения, как будто это было в различном часовом поясе).
Если Вы получаете часовой пояс по умолчанию и содержите на возвращенный объект, он не изменяется если последующий вызов
setDefaultTimeZone:изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Контрастируйте это поведение с объектом, возвращеннымlocalTimeZone.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Устанавливает часовой пояс по умолчанию для текущего приложения к данному часовому поясу.
Объявление
Swift
class func setDefaultTimeZone(_aTimeZone: NSTimeZone)Objective C
+ (void)setDefaultTimeZone:(NSTimeZone *)aTimeZoneПараметры
aTimeZoneНовый часовой пояс по умолчанию для текущего приложения.
Обсуждение
Может быть только один часовой пояс по умолчанию, таким образом, путем установки нового часового пояса по умолчанию, Вы теряете предыдущий.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Сбрасывает объект зоны системного времени, кэшируемый приложением, если таковые имеются.
Объявление
Swift
class func resetSystemTimeZone()Objective C
+ (void)resetSystemTimeZoneОбсуждение
Если приложение кэшировало зону системного времени, этот метод очищает тот кэшируемый объект. Если Вы впоследствии вызываете
systemTimeZone,NSTimeZoneпопытается повторно определить зону системного времени, и новый объект будет создаваться и кэшироваться (см.systemTimeZone).Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает часовой пояс, в настоящее время используемый системой.
Объявление
Swift
class func systemTimeZone() -> NSTimeZoneObjective C
+ (NSTimeZone *)systemTimeZoneВозвращаемое значение
Часовой пояс в настоящее время используется системой. Если зона текущего времени не может быть определена, возвращает часовой пояс GMT.
Специальные замечания
Если Вы получаете зону системного времени, она кэшируется приложением и не изменяется, если пользователь впоследствии изменяет зону системного времени. В следующий раз Вы вызываете
systemTimeZone, Вы возвращаете тот же часовой пояс, который Вы первоначально получили. Необходимо вызватьresetSystemTimeZoneочистить кэшируемый объект.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает словарь, содержащий отображения сокращений часового пояса к именам часового пояса.
Объявление
Swift
class func abbreviationDictionary() -> [NSObject : AnyObject]Objective C
+ (NSDictionary *)abbreviationDictionaryВозвращаемое значение
Словарь, содержащий отображения сокращений часового пояса к именам часового пояса.
Обсуждение
Обратите внимание на то, что больше чем один часовой пояс может иметь то же сокращение — например, США/Тихий океан и Канада/Тихий океан оба используют сокращение «PST». В этих случаях,
abbreviationDictionaryвыбирает единственное имя для отображения сокращения на.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив строк, перечисляющих IDs все время зон, известных системе.
Объявление
Swift
class func knownTimeZoneNames() -> [AnyObject]Objective C
+ (NSArray *)knownTimeZoneNamesВозвращаемое значение
Массив строк, перечисляющих IDs все время зон, известных системе.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Устанавливает словарь сокращения в указанный словарь.
Объявление
Swift
class func setAbbreviationDictionary(_dict: [NSObject : AnyObject])Objective C
+ (void)setAbbreviationDictionary:(NSDictionary *)dictПараметры
dictСловарь, содержащий пары ключ/значение для поиска часового пояса, называет данным их сокращения. Ключи должны быть
NSStringобъекты, содержащие сокращения; значения должны бытьNSStringобъекты, содержащие их соответствующие геополитические имена области.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 4.0 и позже.
-
abbreviationСвойствоСокращение для получателя, такого как «EDT» (Восточное поясное время). (только для чтения)
Объявление
Swift
var abbreviation: String? { get }Objective C
@property(readonly, copy) NSString *abbreviationОбсуждение
Вызывает
abbreviationForDate:с текущей датой как параметр.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает сокращение для получателя в данной дате.
Объявление
Параметры
aDateДата, для которой можно получить сокращение для получателя.
Возвращаемое значение
Сокращение для получателя в
aDate.Обсуждение
Обратите внимание на то, что сокращение может отличаться в различных датах. Например, в течение летнего времени часовой пояс США / Восточный часовой пояс имеют сокращение «EDT». В других случаях его сокращением является «EST».
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
nameСвойство -
secondsFromGMTСвойствоТекущее различие в секундах между получателем и Среднее время по Гринвичу. (только для чтения)
Объявление
Swift
var secondsFromGMT: Int { get }Objective C
@property(readonly) NSInteger secondsFromGMTОператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает различие в секундах между получателем и Среднее время по Гринвичу в данной дате.
Объявление
Параметры
aDateДата, против которой можно протестировать получатель.
Возвращаемое значение
Различие в секундах между получателем и Среднее время по Гринвичу в
aDate.Обсуждение
Если часовой пояс изменяет свое смещение от GMT в различных точках в году — например, изменение часовых поясов США с летним временем, различие может отличаться от текущего различия.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
dataСвойствоДанные, хранящие информацию, используемую получателем. (только для чтения)
Объявление
Swift
@NSCopying var data: NSData { get }Objective C
@property(readonly, copy) NSData *dataОбсуждение
Эти данные должны быть обработаны как непрозрачный объект.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает булево значение, указывающее, имеет ли получатель то же имя и данные как зона требуемого времени.
Объявление
Swift
func isEqualToTimeZone(_aTimeZone: NSTimeZone) -> BoolObjective C
- (BOOL)isEqualToTimeZone:(NSTimeZone *)aTimeZoneПараметры
aTimeZoneЧасовой пояс для сравнения получателю.
Возвращаемое значение
YEStrueеслиaTimeZoneи получатель имеет то же имя и данные, иначеNOfalse.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
descriptionСвойствоОписание получателя, включая имя, сокращение, смещенное от GMT, и является ли летнее время в настоящее время в действительности. (только для чтения)
Объявление
Swift
var description: String { get }Objective C
@property(readonly, copy) NSString *descriptionОператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает имя получателя, локализованного для данной локали.
Объявление
Swift
func localizedName(_style: NSTimeZoneNameStyle, localelocale: NSLocale?) -> String?Objective C
- (NSString *)localizedName:(NSTimeZoneNameStyle)stylelocale:(NSLocale *)localeПараметры
styleСтиль форматирования для возвращаемой строки.
localeЛокаль, для которой можно отформатировать имя.
Возвращаемое значение
Имя получателя, локализованного для
localeиспользованиеstyle.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
daylightSavingTimeСвойствоБулево значение, указывающее, использует ли получатель в настоящее время летнее время. (только для чтения)
Объявление
Swift
var daylightSavingTime: Bool { get }Objective C
@property(readonly, getter=isDaylightSavingTime) BOOL daylightSavingTimeОбсуждение
Если
YEStrue, получатель в настоящее время использует летнее время, иначеNOfalse. Это свойство вызываетisDaylightSavingTimeForDate:с текущей датой как параметр.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 8.0 и позже.
-
daylightSavingTimeOffsetСвойствоТекущее смещение летнего времени получателя. (только для чтения)
Объявление
Swift
var daylightSavingTimeOffset: NSTimeInterval { get }Objective C
@property(readonly) NSTimeInterval daylightSavingTimeOffsetОператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает булево значение, указывающее, использует ли получатель летнее время в данной дате.
Объявление
Swift
func isDaylightSavingTimeForDate(_aDate: NSDate) -> BoolObjective C
- (BOOL)isDaylightSavingTimeForDate:(NSDate *)aDateПараметры
aDateДата, против которой можно протестировать получатель.
Возвращаемое значение
YEStrueесли получатель использует летнее время вaDate, иначеNOfalse.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает смещение летнего времени для данной даты.
Объявление
Swift
func daylightSavingTimeOffsetForDate(_aDate: NSDate) -> NSTimeIntervalObjective C
- (NSTimeInterval)daylightSavingTimeOffsetForDate:(NSDate *)aDateПараметры
aDateДата.
Возвращаемое значение
Смещение летнего времени для
aDate.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
nextDaylightSavingTimeTransitionСвойствоДата следующего раза переход для получателя.
Объявление
Swift
@NSCopying var nextDaylightSavingTimeTransition: NSDate? { get }Objective C
@property(readonly, copy) NSDate *nextDaylightSavingTimeTransitionОбсуждение
Это свойство содержит дату следующего (после текущего момента) переход летнего времени для получателя. В зависимости от часового пояса получателя значение этого свойства может представлять изменение смещения часового пояса от GMT.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Возвращает в следующий раз переход после данной даты.
Объявление
Параметры
aDateДата.
Возвращаемое значение
В следующий раз переход после
aDate. В зависимости от часового пояса получателя этот метод может возвратить изменение смещения часового пояса от GMT.Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
Укажите стили для представления имен часового пояса.
Объявление
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;Константы
-
StandardNSTimeZoneNameStyleStandardУказывает стиль стандартного имени. Например, “Центральное Стандартное Время” для центрального поясного времени.
Доступный в iOS 2.0 и позже.
-
ShortStandardNSTimeZoneNameStyleShortStandardУказывает стиль краткого названия. Например, «CST» для центрального поясного времени.
Доступный в iOS 2.0 и позже.
-
DaylightSavingNSTimeZoneNameStyleDaylightSavingУказывает стиль имени перехода на летнее время. Например, “Центральное Летнее время” для центрального поясного времени.
Доступный в iOS 2.0 и позже.
-
ShortDaylightSavingNSTimeZoneNameStyleShortDaylightSavingУказывает короткий стиль имени перехода на летнее время. Например, «CDT» для центрального поясного времени.
Доступный в iOS 2.0 и позже.
-
GenericNSTimeZoneNameStyleGenericУказывает стиль родового названия. Например, «центральное поясное время» для центрального поясного времени.
Доступный в iOS 4.0 и позже.
-
ShortGenericNSTimeZoneNameStyleShortGenericУказывает универсальное имя часового пояса. Например, «CT» для центрального поясного времени.
Доступный в iOS 4.0 и позже.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
-
-
Отправленный, когда изменился часовой пояс.
Оператор импорта
Objective C
@import Foundation;Swift
import FoundationДоступность
Доступный в iOS 2.0 и позже.
