DateAndTime.DateString Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Returns or sets a String value representing the current date according to your system.

Namespace:   Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public static string DateString {
	[HostProtectionAttribute(SecurityAction.LinkDemand, Resources = HostProtectionResource.ExternalProcessMgmt)]

Property Value

Type: System.String

Returns or sets a String value representing the current date according to your system.

Exception Condition

Invalid format used to set the value of DateString.

DateString returns the system date in the MM-dd-yyyy format, which uses the abbreviated month name. The accepted formats for the date are M-d-yyyy, M-d-y, M/d/yyyy, and M/d/y. This is true for all system locales except those that use a double-byte character set (DBCS). If the system locale uses a double-byte character set, DateString returns the system date in the yyyy-MM-dd format. The system locale is set by using the Clock, Language, and Region item in Control Panel.

Note   The DateString property returns the system date only in the yyyy-MM-dd format for the zh (Chinese simplified), ko (Korean), and ja (Japanese) system locales if you are running Visual Basic within Silverlight.

To get or set the current system time as a String, use the TimeString property.

To get the current system date or time in the format of your locale, or in a custom format, supply the Now property to the Format function, specifying either a predefined or user-defined date/time format. The following example demonstrates this.

MsgBox("The formatted date is " & Format(Now, "dddd, d MMM yyyy"))

To access the current system date as a Date, use the Today property.

System_CAPS_security Security Note

Setting the system date or time requires unmanaged code permission, which might affect its execution in partial-trust situations. For more information, see SecurityPermission and Code Access Permissions.

The following example uses the DateString property to display the current system date.

MsgBox("The current date is " & DateString)

.NET Framework
Available since 1.1
Available since 2.0
Return to top