.NET - Working with DateTime and TimeZones

Working with DateTime and TimeZones in .NET

Handling date and time effectively is crucial in modern software development, especially when dealing with global applications. The .NET framework provides a rich set of classes to work with dates, times, and time zones using DateTime, DateTimeOffset, and TimeZoneInfo. In this guide, we’ll cover the essentials and advanced features of date and time manipulation in C# and .NET Core.

Understanding DateTime in C#

The DateTime struct in C# represents dates and times with values ranging from 00:00:00 on January 1, 0001, to 11:59:59 PM on December 31, 9999. It's one of the most used structs in the .NET framework.

Creating a DateTime Object

DateTime now = DateTime.Now;
DateTime utcNow = DateTime.UtcNow;
DateTime specificDate = new DateTime(2023, 12, 25, 10, 30, 0);

DateTime.Now returns the local system time, whereas DateTime.UtcNow gives you the Coordinated Universal Time.

Common DateTime Properties

Console.WriteLine(now.Year);       // 2025
Console.WriteLine(now.Month);      // 8
Console.WriteLine(now.Day);        // 1
Console.WriteLine(now.DayOfWeek);  // Friday
Console.WriteLine(now.Kind);       // Local or Utc

Formatting DateTime in C#

Formatting is essential for displaying dates in a readable or region-specific format. The ToString() method allows custom and standard formats.

Standard DateTime Formats

DateTime date = DateTime.Now;
Console.WriteLine(date.ToString("d"));  // 8/1/2025
Console.WriteLine(date.ToString("D"));  // Friday, August 1, 2025
Console.WriteLine(date.ToString("t"));  // 11:00 AM
Console.WriteLine(date.ToString("T"));  // 11:00:00 AM

Custom DateTime Formats

Console.WriteLine(date.ToString("yyyy-MM-dd HH:mm:ss"));  // 2025-08-01 11:00:00
Console.WriteLine(date.ToString("dddd, MMMM dd yyyy"));   // Friday, August 01 2025

Parsing DateTime Strings

You can convert a date string into a DateTime object using DateTime.Parse() or DateTime.TryParse().

string dateStr = "2025-08-01";
DateTime parsedDate = DateTime.Parse(dateStr);
Console.WriteLine(parsedDate);

For safe parsing:

DateTime result;
if (DateTime.TryParse("2025-08-01", out result))
{
    Console.WriteLine(result);
}

DateTime Arithmetic

You can perform arithmetic with DateTime by adding or subtracting TimeSpan or using built-in methods.

DateTime today = DateTime.Now;
DateTime nextWeek = today.AddDays(7);
DateTime lastMonth = today.AddMonths(-1);

TimeSpan duration = nextWeek - today;
Console.WriteLine(duration.TotalDays);  // 7

Using DateTimeOffset

DateTimeOffset represents a point in time relative to UTC. It's recommended over DateTime for scenarios involving time zones.

DateTimeOffset dto = DateTimeOffset.Now;
Console.WriteLine(dto);               // 2025-08-01T11:00:00+05:30
Console.WriteLine(dto.UtcDateTime);   // UTC time

DateTimeOffset is ideal for storing timestamps from different time zones without losing accuracy.

TimeZoneInfo in .NET

The TimeZoneInfo class allows converting between time zones and retrieving information about them.

List All Time Zones

foreach (var tz in TimeZoneInfo.GetSystemTimeZones())
{
    Console.WriteLine(tz.Id + " => " + tz.DisplayName);
}

Convert Time Between Time Zones

DateTime utc = DateTime.UtcNow;
TimeZoneInfo indiaZone = TimeZoneInfo.FindSystemTimeZoneById("India Standard Time");
DateTime indiaTime = TimeZoneInfo.ConvertTimeFromUtc(utc, indiaZone);
Console.WriteLine("India Time: " + indiaTime);

Handling Daylight Saving Time (DST)

Some time zones observe DST. You can check if a time is within DST using:

TimeZoneInfo tz = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");
bool isDst = tz.IsDaylightSavingTime(DateTime.Now);
Console.WriteLine(isDst);

Best Practices for Working with Dates and Times

• Always store time in UTC in databases.
• Use DateTimeOffset for APIs and globally-aware systems.
• Use ISO 8601 format (yyyy-MM-ddTHH:mm:ssZ) for interoperability.
• Use TimeZoneInfo to convert to local time zones for display.

Common Pitfalls and How to Avoid Them

1. Ambiguous Time Zones

Do not rely on local time without confirming the region. Different systems may have different settings.

2. DateTime.Kind Misuse

DateTime local = DateTime.Now; // Kind = Local
DateTime utc = DateTime.UtcNow; // Kind = Utc

Always check Kind property before converting between time zones.

3. Using DateTime instead of DateTimeOffset

DateTime doesn’t preserve the offset from UTC. Always use DateTimeOffset when working with global time.

Serializing and Deserializing DateTime

JSON Serialization

public class Event
{
    public string Name { get; set; }
    public DateTimeOffset EventDate { get; set; }
}

Using System.Text.Json

var evt = new Event { Name = "Launch", EventDate = DateTimeOffset.Now };
string json = JsonSerializer.Serialize(evt);
Console.WriteLine(json);

Unit Testing with DateTime

Avoid using DateTime.Now directly in production logic. Use abstraction for testability.

public interface IClock
{
    DateTime Now { get; }
}

public class SystemClock : IClock
{
    public DateTime Now => DateTime.Now;
}

Now inject IClock into your service for better unit testing.

Working with DateOnly and TimeOnly (.NET 6+)

For apps where only date or time is relevant, use new types in .NET 6:

DateOnly date = DateOnly.FromDateTime(DateTime.Now);
TimeOnly time = TimeOnly.FromDateTime(DateTime.Now);

Console.WriteLine(date);  // 08/01/2025
Console.WriteLine(time);  // 11:00 AM

Handling date and time properly is essential in modern applications, especially those operating across time zones. In .NET, you can choose between DateTime, DateTimeOffset, and TimeZoneInfo depending on your needs. Always prefer UTC for storage and conversions, use TimeZoneInfo for localized displays, and avoid hardcoding offsets. Whether you're building APIs, global applications, or local tools, mastering DateTime in C# is key to reliability and correctness.