System.DateTime Structure

Summary

The System.DateTime structure represents an instant in time, expressed as a date and time of day. It is a value type that can store values ranging from 12:00:00 AM January 1, 0001, to 11:59:59 PM December 31, 9999, in the Gregorian calendar. DateTime values are represented internally as the number of 100-nanosecond intervals that have elapsed since 12:00:00 AM January 1, 0001, Coordinated Universal Time (UTC). This structure is fundamental for handling date and time operations in .NET applications.

Properties

Methods

Constructors

Usage Example

Here's a simple example demonstrating common DateTime operations:

using System;

public class DateTimeExample
{
    public static void Main()
    {
        // Get the current date and time
        DateTime now = DateTime.Now;
        Console.WriteLine($"Current date and time: {now}");

        // Get the current UTC date and time
        DateTime utcNow = DateTime.UtcNow;
        Console.WriteLine($"Current UTC date and time: {utcNow}");

        // Create a specific date and time
        DateTime specificDate = new DateTime(2023, 10, 26, 14, 30, 0);
        Console.WriteLine($"Specific date and time: {specificDate}");

        // Add days to a date
        DateTime futureDate = specificDate.AddDays(7);
        Console.WriteLine($"Date after 7 days: {futureDate}");

        // Get the day of the week
        Console.WriteLine($"Day of the week for specificDate: {specificDate.DayOfWeek}");

        // Format a DateTime object
        Console.WriteLine($"Formatted date: {specificDate.ToString("yyyy-MM-dd HH:mm:ss")}");

        // Parse a string into a DateTime object
        string dateString = "2024-01-01 10:00:00";
        if (DateTime.TryParse(dateString, out DateTime parsedDate))
        {
            Console.WriteLine($"Parsed date: {parsedDate}");
        }
        else
        {
            Console.WriteLine("Failed to parse date string.");
        }
    }
}

See Also

• System.TimeSpan
• System.DateTimeKind
• IFormatProvider