Under the Bridge

NSDateFormatter formatting

Ever wonder just what you could put in NSDateFormatter format strings? Enough to actually go to the trouble of actually dumping specifiers and results? Nah, us neither. But somebody did, and here’s what they found:

a: AM/PM
A: 0~86399999 (Millisecond of Day)

c/cc: 1~7 (Day of Week)
ccc: Sun/Mon/Tue/Wed/Thu/Fri/Sat
cccc: Sunday/Monday/Tuesday/Wednesday/Thursday/Friday/Saturday

d: 1~31 (0 padded Day of Month)
D: 1~366 (0 padded Day of Year)

e: 1~7 (0 padded Day of Week)
E~EEE: Sun/Mon/Tue/Wed/Thu/Fri/Sat
EEEE: Sunday/Monday/Tuesday/Wednesday/Thursday/Friday/Saturday

F: 1~5 (0 padded Week of Month, first day of week = Monday)

g: Julian Day Number (number of days since 4713 BC January 1)
G~GGG: BC/AD (Era Designator Abbreviated)
GGGG: Before Christ/Anno Domini

h: 1~12 (0 padded Hour (12hr))
H: 0~23 (0 padded Hour (24hr))

k: 1~24 (0 padded Hour (24hr)
K: 0~11 (0 padded Hour (12hr))

L/LL: 1~12 (0 padded Month)
LLL: Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Nov/Dec
LLLL: January/February/March/April/May/June/July/August/September/October/November/December

m: 0~59 (0 padded Minute)
M/MM: 1~12 (0 padded Month)
MMM: Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Nov/Dec
MMMM: January/February/March/April/May/June/July/August/September/October/November/December

q/qq: 1~4 (0 padded Quarter)
qqq: Q1/Q2/Q3/Q4
qqqq: 1st quarter/2nd quarter/3rd quarter/4th quarter
Q/QQ: 1~4 (0 padded Quarter)
QQQ: Q1/Q2/Q3/Q4
QQQQ: 1st quarter/2nd quarter/3rd quarter/4th quarter

s: 0~59 (0 padded Second)
S: (rounded Sub-Second)

u: (0 padded Year)

v~vvv: (General GMT Timezone Abbreviation)
vvvv: (General GMT Timezone Name)

w: 1~53 (0 padded Week of Year, 1st day of week = Sunday, NB: 1st week of year starts from the last Sunday of last year)
W: 1~5 (0 padded Week of Month, 1st day of week = Sunday)

y/yyyy: (Full Year)
yy/yyy: (2 Digits Year)
Y/YYYY: (Full Year, starting from the Sunday of the 1st week of year)
YY/YYY: (2 Digits Year, starting from the Sunday of the 1st week of year)

z~zzz: (Specific GMT Timezone Abbreviation)
zzzz: (Specific GMT Timezone Name)
Z: +0000 (RFC 822 Timezone)

What, their word not good enough for you? You want an iPhone program to test it out for yourself? Well, here you can download that too. That should settle your date and time formatting needs once and for all!

UPDATES:

Swiftly getting a human-readable date with NSDateFormatter

15
  • http://www.benzado.com/ Benjamin Ragheb

    Is there some problem with just reading the spec linked to by the documentation?

    http://unicode.org/reports/tr35/tr35-6.html#Date_Format_Patterns

  • http://www.alexcurylo.com/ Alex

    Because you should never believe a spec is implemented correctly until you run code that proves it! And even then, a healthy skepticism is still in order…

  • Sanjay

    Many Many Thanks

  • Bob

    hi, Alex.

    Thanks for your kind. I have found it more times.

  • http://absentdesign.com Reuben

    Thanks for this, very handy.

  • Andy

    Thanks for this. So useful.

  • http://loansforphysician.net loans for doctors

    Terrific post however , I was wondering if you could write a litte more on this topic? I’d be very thankful if you could elaborate a little bit more. Thanks!

  • Noman

    Really helpful.

  • Frank Esteban A

    thanks! =)

  • Jasvinder Singh

    thanks

  • Taseen

    Huge thanks.. saved me lot of time

  • Lucho

    still using this info!. Thanks.

  • SLboat

    Thank for the detail intro!

  • Pingback: Threadsafe Date Formatting « Under The Bridge()

  • Mike Hollingshead

    thanks Alex, helped me fix the following bug

    [formatter setDateFormat:@”dd-mm-yyyy”];

    was a bit surprised when a date showed up as 03-48-2015 😛