|
Most of the software you write needs implementing some form of date functions returning current date and time. Dates are so much part of everyday life that it becomes easy to work with them without thinking. VB.Net also provides powerful tools for date arithmetic that makes manipulating dates easy.
The Date data type contains date values, time values, or date and time values. The default value of Date is 0:00:00 (midnight) on January 1, 0001. The equivalent .NET data type is System.DateTime.
The DateTime structure represents an instant in time, typically expressed as a date and time of day
'Declaration
<SerializableAttribute> _
Public Structure DateTime _
Implements IComparable, IFormattable, IConvertible, ISerializable,
IComparable(Of DateTime), IEquatable(Of DateTime)
You can also get the current date and time from the DateAndTime class.
The DateAndTime module contains the procedures and properties used in date and time operations.
'Declaration
<StandardModuleAttribute> _
Public NotInheritable Class DateAndTime
Properties and Methods of the DateTime Structure
The following table lists some of the commonly used properties of the DateTime Structure:
| S.N | Property | Description |
|---|
| 1 | Date | Gets the date component of this instance. |
| 2 | Day | Gets the day of the month represented by this instance. |
| 3 | DayOfWeek | Gets the day of the week represented by this instance. |
| 4 | DayOfYear | Gets the day of the year represented by this instance. |
| 5 | Hour | Gets the hour component of the date represented by this instance. |
| 6 | Kind | Gets a value that indicates whether the time represented by this instance is based on local time, Coordinated Universal Time (UTC), or neither. |
| 7 | Millisecond | Gets the milliseconds component of the date represented by this instance. |
| 8 | Minute | Gets the minute component of the date represented by this instance. |
| 9 | Month | Gets the month component of the date represented by this instance. |
| 10 | Now | Gets a DateTime object that is set to the current date and time on this computer, expressed as the local time. |
| 11 | Second | Gets the seconds component of the date represented by this instance. |
| 12 | Ticks | Gets the number of ticks that represent the date and time of this instance. |
| 13 | TimeOfDay | Gets the time of day for this instance. |
| 14 | Today | Gets the current date. |
| 15 | UtcNow | Gets a DateTime object that is set to the current date and time on this computer, expressed as the Coordinated Universal Time (UTC). |
| 16 | Year | Gets the year component of the date represented by this instance. |
The following table lists some of the commonly used methods of the DateTime structure:
| S.N | Method Name & Description |
|---|
| 1 | Public Function Add (
value As TimeSpan
) As DateTime
Returns a new DateTime that adds the value of the specified TimeSpan to the value of this instance. |
| 2 | Public Function AddDays (
value As Double
) As DateTime
Returns a new DateTime that adds the specified number of days to the value of this instance. |
| 3 | Public Function AddHours (
value As Double
) As DateTime
Returns a new DateTime that adds the specified number of hours to the value of this instance. |
| 4 | Public Function AddMinutes (
value As Double
) As DateTime
Returns a new DateTime that adds the specified number of minutes to the value of this instance. |
| 5 | Public Function AddMonths (
months As Integer
) As DateTime
Returns a new DateTime that adds the specified number of months to the value of this instance. |
| 6 | Public Function AddSeconds (
value As Double
) As DateTime
Returns a new DateTime that adds the specified number of seconds to the value of this instance. |
| 7 | Public Function AddYears (
value As Integer
) As DateTime
Returns a new DateTime that adds the specified number of years to the value of this instance. |
| 8 | Public Shared Function Compare (
t1 As DateTime,
t2 As DateTime
) As Integer
Compares two instances of DateTime and returns an integer that indicates whether the first instance is earlier than, the same as, or later than the second instance. |
| 9 | Public Function CompareTo (
value As DateTime
) As Integer
Compares the value of this instance to a specified DateTime value and returns an integer that indicates whether this instance is earlier than, the same as, or later than the specified DateTime value. |
| 10 | Public Function Equals (
value As DateTime
) As Boolean
Returns a value indicating whether the value of this instance is equal to the value of the specified DateTime instance. |
| 11 | Public Shared Function Equals (
t1 As DateTime,
t2 As DateTime
) As Boolean
Returns a value indicating whether two DateTime instances have the same date and time value. |
| 12 | Public Overrides Function ToString As String
Converts the value of the current DateTime object to its equivalent string representation. |
Creating a DateTime Object
You can create a DateTime object, in one of the following ways:
By calling a DateTime constructor from any of the overloaded DateTime constructors. By assigning the DateTime object a date and time value returned by a property or method. By parsing the string representation of a date and time value. By calling the DateTime structure's implicit default constructor.
Predefined Date/Time Formats
The following table identifies the predefined date and time format names. These may be used by name as the style argument for the Format function:
| Format | Description |
|---|
| General Date, or G | Displays a date and/or time. For example, 1/12/2012 07:07:30 AM. |
| Long Date,Medium Date, or D | Displays a date according to your current culture's long date format. For example, Sunday, December 16, 2012. |
| Short Date, or d | Displays a date using your current culture's short date format. For example, 12/12/2012. |
| Long Time,Medium Time, orT | Displays a time using your current culture's long time format; typically includes hours, minutes, seconds. For example, 01:07:30 AM. |
| Short Time or t | Displays a time using your current culture's short time format. For example, 11:07 AM. |
| f | Displays the long date and short time according to your current culture's format. For example, Sunday, December 16, 2012 12:15 AM. |
| F | Displays the long date and long time according to your current culture's format. For example, Sunday, December 16, 2012 12:15:31 AM. |
| g | Displays the short date and short time according to your current culture's format. For example, 12/16/2012 12:15 AM. |
| M, m | Displays the month and the day of a date. For example, December 16. |
| R, r | Formats the date according to the RFC1123Pattern property. |
| s | Formats the date and time as a sortable index. For example, 2012-12-16T12:07:31. |
| u | Formats the date and time as a GMT sortable index. For example, 2012-12-16 12:15:31Z. |
| U | Formats the date and time with the long date and long time as GMT. For example, Sunday, December 16, 2012 6:07:31 PM. |
| Y, y | Formats the date as the year and month. For example, December, 2012. |
Properties and Methods of the DateAndTime Class
The following table lists some of the commonly used properties of the DateAndTime Class:
| S.N | Property | Description |
|---|
| 1 | Date | Returns or sets a String value representing the current date according to your system. |
| 2 | Now | Returns a Date value containing the current date and time according to your system. |
| 3 | TimeOfDay | Returns or sets a Date value containing the current time of day according to your system. |
| 4 | Timer | Returns a Double value representing the number of seconds elapsed since midnight. |
| 5 | TimeString | Returns or sets a String value representing the current time of day according to your system. |
| 6 | Today | Gets the current date. |
|
