Strings.FormatDateTime(DateTime, DateFormat) 方法

定义

命名空间:
Microsoft.VisualBasic
程序集:
Microsoft.VisualBasic.dll

返回表示日期/时间值的字符串表达式。

public static string FormatDateTime(DateTime Expression, Microsoft.VisualBasic.DateFormat NamedFormat = Microsoft.VisualBasic.DateFormat.GeneralDate);
static member FormatDateTime : DateTime * Microsoft.VisualBasic.DateFormat -> string
Public Function FormatDateTime (Expression As DateTime, Optional NamedFormat As DateFormat = Microsoft.VisualBasic.DateFormat.GeneralDate) As String

参数

Expression
DateTime

必填。 Date 要设置格式的表达式。

NamedFormat
DateFormat

可选。 指示使用的日期/时间格式的数值。 如果省略，将使用 DateFormat.GeneralDate。

返回

String

表示日期/时间值的字符串表达式。

例外

ArgumentException

NamedFormat 设置无效。

示例

此示例演示函数 FormatDateTime 的使用。

' English (US) format.
Dim testDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim testString As String = FormatDateTime(testDate, DateFormat.LongDate)

注解

Date数据类型始终包含日期和时间信息。 出于类型转换的目的，Visual Basic将日期的 1/1/1（第 1 年 1 月 1 日）视为中性值，而 00：00：00（午夜）视为时间的中性值。 如果将值格式化 Date 为日期/时间字符串， FormatDateTime 则不会在生成的字符串中包含中性值。 例如，如果将 #1/1/0001 9：30：00# 转换为字符串，则结果为“9：30：00 AM”;取消日期信息。 但是，日期信息仍存在于原始 Date 值中，并且可以使用函数（例如 DatePart）进行恢复。

注释

如果将参数作为String文本传递Expression，FormatDateTime请根据CurrentCulture应用程序的设置对其进行解释。 但是，如果将它作为 Date 文本传递，请使用格式 #mm/dd/yyyy#，因为 FormatDateTime 始终根据英语（美国）区域性解释文本 Date 。 这是必要的，因为，如果应用程序是使用 Date 一种区域性中的文本开发和编码的，但在具有不同区域性的平台上执行， Date 则文本可以错误地分析。

该 NamedFormat 参数具有以下设置。

常量 Description
DateFormat.GeneralDate 显示日期和/或时间。 将日期部件显示为短日期。 如果有时间部分，则将其显示为较长时间。 如果存在，则显示这两个部分。
DateFormat.LongDate 使用计算机区域设置中指定的长日期格式显示日期。
DateFormat.ShortDate 使用计算机区域设置中指定的短日期格式显示日期。
DateFormat.LongTime 使用计算机的区域设置中指定的时间格式显示时间。
DateFormat.ShortTime 使用 24 小时格式 (hh：mm) 显示时间。

适用于

另请参阅