DateTime | C # in a Nutshell, Second Edition

DateTime

CF 1.0, ECMA 1.0, serializable

System (mscorlib.dll)

struct

This simple value type represents a moment in time from 12:00:00 A.M., 1/1/0001 C.E. (Common Era), to 11:59:59 P.M., 12/31/9999 C.E., which is measured to the nearest tick , or 100-nanosecond interval. You can use this type in greater-than/ less-than comparisons, sorting, and in calculations using other DateTime or TimeSpan instances. You can also use convenient Add. . . methods , such as AddSeconds( ) , with a positive or negative value.

To extract part of a date, use properties such as Day and Minute . All properties except Ticks represent a single component of a compound date, not the whole date. You can convert a string into a DateTime using the static Parse( ) or ParseExact( ) methods, which require that the date match the pattern specified by a supplied format string.

The DateTime class also provides valuable static functions that can determine the number of days in a month ( DaysInMonth( ) ), evaluate whether a year is a leap year ( IsLeapYear( ) ), and retrieve the date stamp from a file ( FromFileTime( ) ). You can also get the current date from the static property Today (or UtcNow for the coordinated universal time).

 public struct  DateTime  : IComparable, IFormattable, IConvertible {  // Public Constructors  public  DateTime  (int   year   , int   month   , int   day   );    public  DateTime  (int   year   , int   month   , int   day   , System.Globalization.Calendar   calendar   );    public  DateTime  (int   year   , int   month   , int   day   , int   hour   , int   minute   , int   second   );    public  DateTime  (int   year   , int   month   , int   day   , int   hour   , int   minute   , int   second   ,        System.Globalization.Calendar   calendar   );    public  DateTime  (int   year   , int   month   , int   day   , int   hour   , int   minute   , int   second   ,        int   millisecond   );    public  DateTime  (int   year   , int   month   , int   day   , int   hour   , int   minute   , int   second   ,          int   millisecond   , System.Globalization.Calendar   calendar   );    public  DateTime  (long   ticks   );  // Public Static Fields  public static readonly DateTime  MaxValue  ;  // =12/31/9999 11:59:59 PM  public static readonly DateTime  MinValue  ;  // =1/1/0001 12:00:00 AM   // Public Static Properties  public static DateTime  Now  {get; }    public static DateTime  Today  {get; }    public static DateTime  UtcNow  {get; }  // Public Instance Properties  public DateTime  Date  {get; }    public int  Day  {get; }    public DayOfWeek  DayOfWeek  {get; }    public int  DayOfYear  {get; }    public int  Hour  {get; }    public int  Millisecond  {get; }    public int  Minute  {get; }    public int  Month  {get; }    public int  Second  {get; }    public long  Ticks  {get; }    public TimeSpan  TimeOfDay  {get; }    public int  Year  {get; }  // Public Static Methods  public static int  Compare  (DateTime   t1   , DateTime   t2   );    public static int  DaysInMonth  (int   year   , int   month   );    public static bool  Equals  (DateTime   t1   , DateTime   t2   );    public static DateTime  FromFileTime  (long   fileTime   );    public static DateTime  FromFileTimeUtc  (long   fileTime   );    public static DateTime  FromOADate  (double   d   );    public static bool  IsLeapYear  (int   year   );    public static DateTime  Parse  (string   s   );    public static DateTime  Parse  (string   s   , IFormatProvider   provider   );    public static DateTime  Parse  (string   s   , IFormatProvider   provider   ,          System.Globalization.DateTimeStyles   styles   );    public static DateTime  ParseExact  (string   s   , string[ ]   formats   , IFormatProvider   provider   ,         System.Globalization.DateTimeStyles   style   );    public static DateTime  ParseExact  (string   s   , string   format   , IFormatProvider   provider   );    public static DateTime  ParseExact  (string   s   , string   format   , IFormatProvider   provider   ,          System.Globalization.DateTimeStyles   style   );    public static DateTime operator  -  (DateTime   d   , TimeSpan   t   );    public static TimeSpan operator  -  (DateTime   d1   , DateTime   d2   );    public static DateTime operator  +  (DateTime   d   , TimeSpan   t   );    public static bool operator  !=  (DateTime   d1   , DateTime   d2   );    public static bool operator  <  (DateTime   t1   , DateTime   t2   );    public static bool operator  <=  (DateTime   t1   , DateTime   t2   );    public static bool operator  =  =  (DateTime   d1   , DateTime   d2   );    public static bool operator  >  (DateTime   t1   , DateTime   t2   );    public static bool operator  >=  (DateTime   t1   , DateTime   t2   );  // Public Instance Methods  public DateTime  Add  (TimeSpan   value   );    public DateTime  AddDays  (double   value   );    public DateTime  AddHours  (double   value   );    public DateTime  AddMilliseconds  (double   value   );    public DateTime  AddMinutes  (double   value   );    public DateTime  AddMonths  (int   months   );    public DateTime  AddSeconds  (double   value   );    public DateTime  AddTicks  (long   value   );    public DateTime  AddYears  (int   value   );    public int  CompareTo  (object   value   );  // implements IComparable  public override bool  Equals  (object   value   );  // overrides ValueType  public string[ ]  GetDateTimeFormats  ( );    public string[ ]  GetDateTimeFormats  (char   format   );    public string[ ]  GetDateTimeFormats  (char   format   , IFormatProvider   provider   );    public string[ ]  GetDateTimeFormats  (IFormatProvider   provider   );    public override int  GetHashCode  ( );  // overrides ValueType  public TypeCode  GetTypeCode  ( );  // implements IConvertible  public DateTime  Subtract  (TimeSpan   value   );    public TimeSpan  Subtract  (DateTime   value   );    public long  ToFileTime  ( );    public long  ToFileTimeUtc  ( );    public DateTime  ToLocalTime  ( );    public string  ToLongDateString  ( );    public string  ToLongTimeString  ( );    public double  ToOADate  ( );    public string  ToShortDateString  ( );    public string  ToShortTimeString  ( );    public override string  ToString  ( );  // overrides ValueType  public string  ToString  (IFormatProvider   provider   );  // implements IConvertible  public string  ToString  (string   format   );    public string  ToString  (string   format   , IFormatProvider   provider   )  // implements IFormattable  public DateTime  ToUniversalTime  ( ); }

Hierarchy

Object ValueType DateTime(IComparable, IFormattable , IConvertible)

Returned By

Multiple types

Passed To

Multiple types