Используйте стили средства форматирования для подарить датам и времени предпочтения пользователя

NSDateFormatter упрощает для Вас форматировать дату с помощью настроек пользователь, сконфигурированный в Международной предпочтительной панели в Установках системы. NSDateFormatter константы стиля —NSDateFormatterNoStyle, NSDateFormatterShortStyle, NSDateFormatterMediumStyle, NSDateFormatterLongStyle, и NSDateFormatterFullStyle— укажите наборы атрибутов, определяющих, как дата выведена на экран согласно предпочтениям пользователя.

Вы указываете стиль компонентов даты и времени средства форматирования даты независимо с помощью setDateStyle: и setTimeStyle: соответственно. Перечисление 1 иллюстрирует, как можно отформатировать дату с помощью стилей средства форматирования. Заметьте использование NSDateFormatterNoStyle подавить компонент времени и привести к строке, содержащей просто дату.

Перечисление 1  , Форматирующее дату с помощью стилей средства форматирования

NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

[dateFormatter setDateStyle:NSDateFormatterMediumStyle];

[dateFormatter setTimeStyle:NSDateFormatterNoStyle];

NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:162000];

NSString *formattedDateString = [dateFormatter stringFromDate:date];

NSLog(@"formattedDateString: %@", formattedDateString);

// Output for locale en_US: "formattedDateString: Jan 2, 2001".

Используйте строки формата для указания пользовательских форматов

Существует вообще говоря две ситуации, в которых необходимо использовать пользовательские форматы:

1. Для строк фиксированного формата, как интернет-даты.

2. Для видимых пользователем элементов, не соответствующих ни одного из существующих стилей

NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

[dateFormatter setDateFormat:@"yyyy-MM-dd 'at' HH:mm"];

NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:162000];

NSString *formattedDateString = [dateFormatter stringFromDate:date];

NSLog(@"formattedDateString: %@", formattedDateString);

// For US English, the output may be:

// formattedDateString: 2001-01-02 at 13:00

NSString *formatString = [NSDateFormatter dateFormatFromTemplate:@"EdMMM" options:0

                                          locale:[NSLocale currentLocale]];

NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

[dateFormatter setDateFormat:formatString];

NSString *todayString = [dateFormatter stringFromDate:[NSDate date]];

NSLog(@"todayString: %@", todayString);

NSLocale *usLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];

NSString *usFormatString = [NSDateFormatter dateFormatFromTemplate:@"EdMMM" options:0 locale:usLocale];

NSLog(@"usFormatterString: %@", usFormatString);

// Output: usFormatterString: EEE, MMM d.

NSLocale *gbLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_GB"];

NSString *gbFormatString = [NSDateFormatter dateFormatFromTemplate:@"EdMMM" options:0 locale:gbLocale];

NSLog(@"gbFormatterString: %@", gbFormatString);

// Output: gbFormatterString: EEE d MMM.

Парсинг строк даты

В дополнение к методам, наследованным от NSFormatter (такой как getObjectValue:forString:errorDescription:), NSDateFormatter добавляет dateFromString: и getObjectValue:forString:range:error:. Эти методы упрощают для Вас использовать NSDateFormatter возразите непосредственно в коде и упростите форматировать даты в строки более сложные и более удобные способы, чем NSString форматирование позволяет.

getObjectValue:forString:range:error: метод позволяет Вам указывать поддиапазон строки, которая будет проанализирована, и это возвращает диапазон строки, фактически проанализированной (в случае отказа, это указывает, где отказ произошел). Это также возвращается NSError объект, который может содержать более богатую информацию, чем строка отказа, возвращенная getObjectValue:forString:errorDescription: метод наследовался от NSFormatter.

Если Вы работаете с датами фиксированного формата, необходимо сначала установить локаль средства форматирования даты к чему-то подходящему для фиксированного формата. В большинстве случаев лучшая локаль для выбора en_US_POSIX, локаль это специально предназначено для получения английских результатов США и независимо от пользовательских настроек и независимо от установок системы. en_US_POSIX является также инвариантным своевременно (если США, в некоторый момент в будущем, изменяют способ, которым это форматирует даты, en_US изменится для отражения нового поведения, но en_US_POSIX не будет), и между платформами (en_US_POSIX работает то же над iPhone OS, как это делает на OS X, и как это делает на других платформах).

Как только Вы установили en_US_POSIX как локаль средства форматирования даты, можно тогда установить строку формата даты, и средство форматирования даты будет последовательно вести себя для всех пользователей.

Перечисление 2 показывает, как использовать NSDateFormatter для обеих из ролей, описанных выше. Сначала это создает a en_US_POSIX средство форматирования даты для парсинга входящей строки даты RFC 3339, с помощью фиксированной строки формата даты и UTC как часовой пояс. Затем, это создает стандартное средство форматирования даты для рендеринга даты как строки для отображения пользователю.

Перечисление 2  , Анализирующее разовый датой RFC 3339

- (NSString *)userVisibleDateTimeStringForRFC3339DateTimeString:(NSString *)rfc3339DateTimeString {

    /*

      Returns a user-visible date time string that corresponds to the specified

      RFC 3339 date time string. Note that this does not handle all possible

      RFC 3339 date time strings, just one of the most common styles.

     */

    NSDateFormatter *rfc3339DateFormatter = [[NSDateFormatter alloc] init];

    NSLocale *enUSPOSIXLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];

    [rfc3339DateFormatter setLocale:enUSPOSIXLocale];

    [rfc3339DateFormatter setDateFormat:@"yyyy'-'MM'-'dd'T'HH':'mm':'ss'Z'"];

    [rfc3339DateFormatter setTimeZone:[NSTimeZone timeZoneForSecondsFromGMT:0]];

    // Convert the RFC 3339 date time string to an NSDate.

    NSDate *date = [rfc3339DateFormatter dateFromString:rfc3339DateTimeString];

    NSString *userVisibleDateTimeString;

    if (date != nil) {

        // Convert the date object to a user-visible date string.

        NSDateFormatter *userVisibleDateFormatter = [[NSDateFormatter alloc] init];

        assert(userVisibleDateFormatter != nil);

        [userVisibleDateFormatter setDateStyle:NSDateFormatterShortStyle];

        [userVisibleDateFormatter setTimeStyle:NSDateFormatterShortStyle];

        userVisibleDateTimeString = [userVisibleDateFormatter stringFromDate:date];

    }

    return userVisibleDateTimeString;

}

Средства форматирования кэша для эффективности

Создание средства форматирования даты не является дешевой работой. Если Вы, вероятно, будете часто использовать средство форматирования, обычно более эффективно кэшировать единственный экземпляр, чем создать и избавиться от многократных экземпляров. Один подход должен использовать a static переменная.

Перечисление 3 повторно реализует метод, который, как показывают в Перечислении 2, держался за средства форматирования даты для последующего повторного использования.

Перечисление 3  , Анализирующее RFC 3339 разовое датой использование кэшируемого средства форматирования

static NSDateFormatter *sUserVisibleDateFormatter = nil;

- (NSString *)userVisibleDateTimeStringForRFC3339DateTimeString:(NSString *)rfc3339DateTimeString {

    /*

      Returns a user-visible date time string that corresponds to the specified

      RFC 3339 date time string. Note that this does not handle all possible

      RFC 3339 date time strings, just one of the most common styles.

     */

    // If the date formatters aren't already set up, create them and cache them for reuse.

    static NSDateFormatter *sRFC3339DateFormatter = nil;

    if (sRFC3339DateFormatter == nil) {

        sRFC3339DateFormatter = [[NSDateFormatter alloc] init];

        NSLocale *enUSPOSIXLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];

        [sRFC3339DateFormatter setLocale:enUSPOSIXLocale];

        [sRFC3339DateFormatter setDateFormat:@"yyyy'-'MM'-'dd'T'HH':'mm':'ss'Z'"];

        [sRFC3339DateFormatter setTimeZone:[NSTimeZone timeZoneForSecondsFromGMT:0]];

    }

    // Convert the RFC 3339 date time string to an NSDate.

    NSDate *date = [rfc3339DateFormatter dateFromString:rfc3339DateTimeString];

    NSString *userVisibleDateTimeString;

    if (date != nil) {

        if (sUserVisibleDateFormatter == nil) {

            sUserVisibleDateFormatter = [[NSDateFormatter alloc] init];

            [sUserVisibleDateFormatter setDateStyle:NSDateFormatterShortStyle];

            [sUserVisibleDateFormatter setTimeStyle:NSDateFormatterShortStyle];

        }

        // Convert the date object to a user-visible date string.

        userVisibleDateTimeString = [sUserVisibleDateFormatter stringFromDate:date];

    }

    return userVisibleDateTimeString;

}

Если Вы кэшируете средства форматирования даты (или любые другие объекты, зависящие от текущей локали пользователя), необходимо подписаться на NSCurrentLocaleDidChangeNotification уведомление и обновление Ваши кэшируемые объекты, когда изменяется текущая локаль. Код в Перечислении 3 определяет sUserVisibleDateFormatter за пределами метода так, чтобы другой код, не показанный, мог обновить его по мере необходимости. Напротив, sRFC3339DateFormatter определяется в методе, потому что проектом это не зависит от настроек локали пользователя.

Рассмотрите функции Unix для фиксированного формата, нелокализованных дат

Для даты и времена в фиксированном, нелокализованном формате, которые, как всегда гарантируют, будут использовать тот же календарь, это может иногда быть проще и более эффективным использовать функции стандартной библиотеки для C strptime_l и strftime_l.

Знайте, что библиотека C также имеет идею текущей локали. Для гарантии фиксированного формата даты необходимо передать NULL как loc параметр этих подпрограмм. Это заставляет их использовать локаль POSIX (также известный как локаль C), который эквивалентен Какао en_US_POSIX локаль, как проиллюстрировано в этом примере.

struct tm  sometime;

const char *formatString = "%Y-%m-%d %H:%M:%S %z";

(void) strptime_l("2005-07-01 12:00:00 -0700", formatString, &sometime, NULL);

NSLog(@"NSDate is %@", [NSDate dateWithTimeIntervalSince1970: mktime(&sometime)]);

// Output: NSDate is 2005-07-01 12:00:00 -0700