However, if you need to display a date in a locale other than the current setting on the device, here’s how to do it:

// Create date object  
NSDate *date = [NSDate date];
 
// Create date formatter
NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
[dateFormat setDateFormat:@"EEEE MMMM d, YYYY"];
 
// Set the locale as needed in the formatter (this example uses Japanese)
[dateFormat setLocale:[[[NSLocale alloc] initWithLocaleIdentifier:@"ja_JP"]
    autorelease]];
 
// Create date string from formatter, using the current date
NSString *dateString = [dateFormat stringFromDate:date];  
 
// We're done with this now
[dateFormat release];
 
// Show that the locale on the device is still set to US 
NSLocale *locale = [NSLocale currentLocale];
NSLog(@"Current Locale: %@", [locale localeIdentifier]);
 
// Display the date string in format we set above
NSLog(@"Date: %@:", dateString);

The output from the code above looks as follows:

More on Date Formatting:

Date Formatter Examples – Take 1: NSDateFormatter
Date Formatter Examples – Take 2: Format Strings
Date Formatter Examples – Take 3: Date from String

I needed a way to display the activity indicator a consistent amount of time for each file save, regardless of how long it took to write the file. Here’s the workaround I came up with – I began by saving the start time and creating an activity indicator:

  // When did we start the image save ?
  // CFTimeInterval is a double (floating point number)
  CFTimeInterval startTime = CFAbsoluteTimeGetCurrent();    
 
  // Start the activity indicator
  UIActivityIndicatorView activityIndicator = [[UIActivityIndicatorView alloc]
                    100, 400, 30, 30];
  activityIndicator.activityIndicatorViewStyle = UIActivityIndicatorViewStyleGray;
  activityIndicator.autoresizingMask = (UIViewAutoresizingFlexibleLeftMargin |
                    UIViewAutoresizingFlexibleRightMargin |
                    UIViewAutoresizingFlexibleTopMargin |
                    UIViewAutoresizingFlexibleBottomMargin);
  [activityIndicator sizeToFit];
  [self.view addSubview:activityIndicator];
  [activityIndicator startAnimating];

Next, I wrote the image to the camera roll and then checked for the amount of time elapsed:

 
  // Save image code here...
 
  // How much time has elapsed ?
  CFTimeInterval difference = CFAbsoluteTimeGetCurrent() - startTime;

The last check I needed was to see if the amount of time that has elapsed was greater or less than the minimum time I wanted to display the activity indicator. If less than the desired amount of time, sleep for the amount of time needed to hit the minimum display time.

  #define SECONDS_TO_DISPLAY_ACTIVITY_INDICATOR 3
 
  ...
 
  // Determine if some predetermined amount of time has passed.  
  if (difference < SECONDS_TO_DISPLAY_ACTIVITY_INDICATOR)
    [NSThread sleepForTimeInterval:SECONDS_TO_DISPLAY_SAVING_MSG - difference];
 
  // Remove the activity indicator and message
  [activityIndicator stopAnimating];  
  [activityIndicator removeFromSuperview];
  [activityIndicator release];

For my needs accuracy was not key. So even though CFTimeInterval is a double, I simply allow any rounding up or down to take place.

How to get there from here is now obvious, however, when I first encountered this dilemma the solution wasn’t apparent. The reason being, there is significant depth in the Cocoa frameworks and half the battle in becoming proficient as an iPhone developer is to have an opportunity to explore the range of APIs. Albeit the solution was right under my nose the whole time, my first pass was to take a more traditional route of trying to parse the string and rebuild a more “traditional” date format which I could use to create a date object. So, skipping all that, here’s the proper solution…

If you’ve ever worked with dates in Cocoa, chances are you are familiar with the stringFromDate method of the NSDateFormatter. For example, the code below will convert the current date to a string that looks like this: Wednesday November 26, 2008

1
2
3
4
5

NSDate *date = [NSDate date];
NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
[dateFormat setDateFormat:@"EEEE MMMM d, YYYY"];
NSString *dateString = [dateFormat stringFromDate:date];  
[dateFormat release];

The trick is two-fold, the date format string to specify desired output, and the method stringFromDate to convert the date object to an NSString.

I’m sure you can see where I’m going with this…the solution I was looking for to convert a date (stored as a string) that was in a pre-defined format (i.e. 20081122) to a date object is as simple as using the method dateFromString. The primary difference is that the format string needs to represent the current format of the date that is to be read (versus the desired output format).

The code below converts a string that represents a date to an NSString object, with the output as follows: Saturday November 22, 2008:

1
2
3
4
5
6
7
8
9
10
11

NSString *dateStr = @"20081122";
 
// Convert string to date object
NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
[dateFormat setDateFormat:@"yyyyMMdd"];
NSDate *date = [dateFormat dateFromString:dateStr];  
 
// Convert date object to desired output format
[dateFormat setDateFormat:@"EEEE MMMM d, YYYY"];
dateStr = [dateFormat stringFromDate:date];  
[dateFormat release];

More on Date Formatting:

Date Formatter Examples – Take 1: NSDateFormatter
Date Formatter Examples – Take 2: Format Strings
Date Formatter Examples – Take 4: Setting Locale

Here is a short list of sample formats using ICU:

The format specifiers are quite straightforward, Y = year, M = month, etc. Changing the number of specifiers for a field, changes the output. For example, MMMM generates the full month name “November”, MMM results in “Nov” and MM outputs “11″.

What follows is an example to create the following date string:

Saturday November 8, 2008:

1
2
3
4
5

NSDate *today = [NSDate date];
NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
[dateFormat setDateFormat:@"EEEE MMMM d, YYYY"];
NSString *dateString = [dateFormat stringFromDate:today];
[dateFormat release];

Here’s another example showing the current time:

9:20 AM, PST:

1
2
3
4
5

NSDate *today = [NSDate date]; 
NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
[dateFormat setDateFormat:@"h:mm a, zzz"];
NSString *dateString = [dateFormat stringFromDate:today];  
[dateFormat release];

More on Date Formatting:

Date Formatter Examples – Take 1: NSDateFormatter
Date Formatter Examples – Take 3: Date from String
Date Formatter Examples – Take 4: Setting Locale

So, to save you some time, here are several simple examples for displaying date information:

1
2
3
4
5
6

 // <strong>Output ->  Date: 10/29/08</strong>
 NSDate *today = [NSDate dateWithTimeIntervalSinceNow:0];
 NSDateFormatter *dateFormat = [[[NSDateFormatter alloc] init] autorelease];
 [dateFormat setDateStyle:NSDateFormatterShortStyle];
 NSString *dateString = [dateFormat stringFromDate:today];
 NSLog(@"Date: %@", dateString);

Notice above how the style of the output is set using NSDateFormatterShortStyle. There are additional canned formats as well such as NSDateFormatterFullStyle and NSDateFormatterNoStyle.

1
2
3
4
5
6
7

 // <strong>Output ->  Date: 10/29/2008 08:29PM</strong>    
 NSDate *today = [NSDate date];
 NSDateFormatter *dateFormat = [[NSDateFormatter alloc] init];
 [dateFormat setDateFormat:@"MM/dd/yyyy hh:mma"];
 NSString *dateString = [dateFormat stringFromDate:today];
 NSLog(@"date: %@", dateString);
 [dateFormat release];

The example above shows how you can manage memory without using autorelease. As suggested in the comment below (thanks Nick) this is generally a preferred approach on the iPhone where applicable.

These examples merely skim the surface of what you can do when working with dates. Look at the documentation for specifics on how to tweak the specifier strings to create variations of the date output.

More on Date Formatting:

Date Formatter Examples – Take 2: Format Strings
Date Formatter Examples – Take 3: Date from String
Date Formatter Examples – Take 4: Setting Locale