NSDateFormatter Class Reference

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

[dateFormatter setTimeStyle:NSDateFormatterNoStyle];

[dateFormatter setDateStyle:NSDateFormatterMediumStyle];

NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:118800];

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

[dateFormatter setLocale:usLocale];

NSLog(@"Date for locale %@: %@",

      [[dateFormatter locale] localeIdentifier], [dateFormatter stringFromDate:date]);

// Output:

// Date for locale en_US: Jan 2, 2001

NSLocale *frLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"fr_FR"];

[dateFormatter setLocale:frLocale];

NSLog(@"Date for locale %@: %@",

      [[dateFormatter locale] localeIdentifier], [dateFormatter stringFromDate:date]);

// Output:

// Date for locale fr_FR: 2 janv. 2001

Tasks

Initializing a Date Formatter

• – initWithDateFormat:allowNaturalLanguage:

Converting Objects

• – dateFromString:
• – stringFromDate:
• + localizedStringFromDate:dateStyle:timeStyle:
• – getObjectValue:forString:range:error:
• – generatesCalendarDates
• – setGeneratesCalendarDates:

Managing Formats and Styles

• – dateFormat
• – setDateFormat:
• – dateStyle
• – setDateStyle:
• – timeStyle
• – setTimeStyle:
• + dateFormatFromTemplate:options:locale:

Managing Attributes

• – calendar
• – setCalendar:
• – defaultDate
• – setDefaultDate:
• – locale
• – setLocale:
• – timeZone
• – setTimeZone:
• – twoDigitStartDate
• – setTwoDigitStartDate:
• – gregorianStartDate
• – setGregorianStartDate:

Managing Behavior Version

• – formatterBehavior
• – setFormatterBehavior:
• + defaultFormatterBehavior
• + setDefaultFormatterBehavior:

Managing Natural Language Support

• – allowsNaturalLanguage
• – isLenient
• – setLenient:
• – doesRelativeDateFormatting
• – setDoesRelativeDateFormatting:

Managing AM and PM Symbols

• – AMSymbol
• – setAMSymbol:
• – PMSymbol
• – setPMSymbol:

Managing Weekday Symbols

• – weekdaySymbols
• – setWeekdaySymbols:
• – shortWeekdaySymbols
• – setShortWeekdaySymbols:
• – veryShortWeekdaySymbols
• – setVeryShortWeekdaySymbols:
• – standaloneWeekdaySymbols
• – setStandaloneWeekdaySymbols:
• – shortStandaloneWeekdaySymbols
• – setShortStandaloneWeekdaySymbols:
• – veryShortStandaloneWeekdaySymbols
• – setVeryShortStandaloneWeekdaySymbols:

Managing Month Symbols

• – monthSymbols
• – setMonthSymbols:
• – shortMonthSymbols
• – setShortMonthSymbols:
• – veryShortMonthSymbols
• – setVeryShortMonthSymbols:
• – standaloneMonthSymbols
• – setStandaloneMonthSymbols:
• – shortStandaloneMonthSymbols
• – setShortStandaloneMonthSymbols:
• – veryShortStandaloneMonthSymbols
• – setVeryShortStandaloneMonthSymbols:

Managing Quarter Symbols

• – quarterSymbols
• – setQuarterSymbols:
• – shortQuarterSymbols
• – setShortQuarterSymbols:
• – standaloneQuarterSymbols
• – setStandaloneQuarterSymbols:
• – shortStandaloneQuarterSymbols
• – setShortStandaloneQuarterSymbols:

Managing Era Symbols

• – eraSymbols
• – setEraSymbols:
• – longEraSymbols
• – setLongEraSymbols:

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

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

NSString *dateFormat;

NSString *dateComponents = @"yMMMMd";

dateFormat = [NSDateFormatter dateFormatFromTemplate:dateComponents options:0 locale:usLocale];

NSLog(@"Date format for %@: %@",

    [usLocale displayNameForKey:NSLocaleIdentifier value:[usLocale localeIdentifier]], dateFormat);

dateFormat = [NSDateFormatter dateFormatFromTemplate:dateComponents options:0 locale:gbLocale];

NSLog(@"Date format for %@: %@",

    [gbLocale displayNameForKey:NSLocaleIdentifier value:[gbLocale localeIdentifier]], dateFormat);

// Output:

// Date format for English (United States): MMMM d, y

// Date format for English (United Kingdom): d MMMM y

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

[formatter setFormatterBehavior:NSDateFormatterBehavior10_4];

[formatter setDateStyle:dateStyle];

[formatter setTimeStyle:timeStyle];

NSString *result = [formatter stringForObjectValue:date];

NSDateFormatter *dateFormat = [[NSDateFormatter alloc]

    initWithDateFormat:@"%b %d %Y" allowNaturalLanguage:NO];

[[contactsForm cells] makeObjectsPerformSelector:@selector(setFormatter:)

     withObject:dateFormat];

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

[dateFormatter setTimeStyle:NSDateFormatterNoStyle];

[dateFormatter setDateStyle:NSDateFormatterMediumStyle];

NSLocale *frLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"fr_FR"];

[dateFormatter setLocale:frLocale];

[dateFormatter setDoesRelativeDateFormatting:YES];

NSDate *date = [NSDate dateWithTimeIntervalSinceNow:60*60*24*3];

NSString *dateString = [dateFormatter stringFromDate:date];

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

// Output

// dateString: après-après-demain

typedef enum {
   NSDateFormatterNoStyle     = kCFDateFormatterNoStyle,
   NSDateFormatterShortStyle  = kCFDateFormatterShortStyle,
   NSDateFormatterMediumStyle = kCFDateFormatterMediumStyle,
   NSDateFormatterLongStyle   = kCFDateFormatterLongStyle,
   NSDateFormatterFullStyle   = kCFDateFormatterFullStyle
} NSDateFormatterStyle;

typedef enum {
   NSDateFormatterBehaviorDefault = 0,
   NSDateFormatterBehavior10_0    = 1000,
   NSDateFormatterBehavior10_4    = 1040,
} NSDateFormatterBehavior;