How to change time and timezone in iPhone simulator?

Viewed 108120

How do I change time and time zone in the iPhone simulator?

11 Answers

You can set the TZ environment variable in an Xcode Scheme to set the time zone just for that app.

Manage Schemes

You can use UTC, PST, EST, as well as place-based timezone names such as America/Los_Angeles. It's not well documented, but I suspect any time zone name should work.

It's not well documented, but the source is an Apple Developer Support rep on the developer forums.

For the purpose of taking a screenshot, Apple finally made it possible to override time on the status bar of iOS simulator (since Xcode 11) by using simctl tool:

xcrun simctl status_bar "iPhone Xs" override --time "21:08"

Here is a solution available from iOS 13 and Xcode 11 at least. (did not test with previous versions) [Edit] This will change only the status bar as in the comments!

By default the iOS Simulator shows whatever the time is on your Mac, however, you can use Xcode’s command line to override that with this command in the terminal:

xcrun simctl status_bar "iPhone 11 Pro Max" override --time '9:41'

Replace the simulator name with the device you want to change.

screenshot of iPhone time

For the status bar you have this overrides:

You may specify any combination of these flags (at least one is required):

--time <string>
     Set the date or time to a fixed value.
     If the string is a valid ISO date string it will also set the date on relevant devices.
--dataNetwork <dataNetworkType>
     If specified must be one of 'wifi', '3g', '4g', 'lte', 'lte-a', or 'lte+'.
--wifiMode <mode>
     If specified must be one of 'searching', 'failed', or 'active'.
--wifiBars <int>
     If specified must be 0-3.
--cellularMode <mode>
     If specified must be one of 'notSupported', 'searching', 'failed', or 'active'.
--cellularBars <int>
     If specified must be 0-4.
--batteryState <state>
     If specified must be one of 'charging', 'charged', or 'discharging'.
--batteryLevel <int>
     If specified must be 0-100.

The time can be any string. But if you want the device to show the date you will need use the ISO format. For example a valid ISO date string would be '2007-01-09T10:41:00+01:00'

Otherwise you can use the time parameter as a string and it will display whatever you pass in it.

With thanks to the original post by Paul Hudson Here's the link!

My build server is UTC and some of my unit tests needed the timezone to be PST. Using a category on NSTimeZone you can override Apple's implementation to use your code. Works for swift only projects too.

//NSTimeZone+DefaultTimeZone.h
#import <Foundation/Foundation.h>

@interface NSTimeZone (DefaultTimeZone)

+(NSTimeZone *)defaultTimeZone;

@end

//NSTimeZone+DefaultTimeZone.m
#import "NSTimeZone+DefaultTimeZone.h"

@implementation NSTimeZone (DefaultTimeZone)

+(NSTimeZone *)defaultTimeZone
{
    return [NSTimeZone timeZoneWithName:@"America/Los_Angeles"];
}

@end

Only working solution for now. XCode does provide option to set a Time Zone for a particular app.

In XCode, Click on your app, Edit Scheme -> Run configuration -> Arguments Tab -> Add Environment Variables

Create a variable with Name: TZ, Value: CST (Any other standard format. XCode didn't explicitly mention the allowed values. But you can use America/Chicago too)

Image for Reference

After changing the system date time preferences I had to choose Hardware > Reset All Content And Settings.
Only this worked for me in Version 10.3 (SimulatorApp-880.5 CoreSimulator-681.5.4).

Related