Strings.FormatDateTime(DateTime, DateFormat) 方法

  • 参考

定义

命名空间:
Microsoft.VisualBasic
程序集:
Microsoft.VisualBasic.Core.dll
程序集:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

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

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 日) 为日期的中性值，00：00：00：00 (午夜) 为该时间的中性值。 如果将值格式化 Date 为日期/时间字符串， FormatDateTime 则不会在生成的字符串中包含非特定值。 例如，如果将 #1/1/0001 9：30：00# 转换为字符串，则结果为“上午 9：30：00”;日期信息被禁止显示。 但是，日期信息仍然存在于原始 Date 值中，并且可以使用 DatePart 等函数进行恢复。

注意

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

参数 NamedFormat 具有以下设置。

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

适用于

另请参阅