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 日) を日付のニュートラル値とし、00:00:00 (午前 0 時) を時間のニュートラル値と見なします。 Date値を日付/時刻文字列として書式設定する場合、FormatDateTime結果の文字列にニュートラル値は含まれません。 たとえば、#1/1/0001 9:30:00# を文字列に変換すると、結果は "9:30:00 AM" になります。日付情報は抑制されます。 ただし、日付情報は元の Date 値に残っており、 DatePartなどの関数を使用して回復できます。

Note

Expression引数をStringリテラルとして渡した場合、FormatDateTimeはアプリケーションのCurrentCulture設定に従って解釈されます。 ただし、 Date リテラルとして渡す場合は、 FormatDateTime は常に英語 (米国) のカルチャに従って Date リテラルを解釈するため、#mm/dd/yyyy# の形式を使用します。 これは、あるカルチャの Date リテラルを使用してアプリケーションを開発してコード化した後、別のカルチャのプラットフォームで実行される場合、 Date リテラルが誤って解析される可能性があるためです。

NamedFormat引数には、次の設定があります。

定数 Description
DateFormat.GeneralDate 日付と時刻を表示します。 日付部分を短い日付として表示します。 時刻の部分がある場合、長い時刻として表示されます。 存在する場合は、両方のパーツが表示されます。
DateFormat.LongDate コンピューターの地域設定で指定された長い日付の書式設定を使用して、日付を表示します。
DateFormat.ShortDate コンピューターの地域設定で指定された短い日付の書式設定を使用して、日付を表示します。
DateFormat.LongTime コンピューターの地域設定で指定された時刻の書式設定を使用して、日付を表示します。
DateFormat.ShortTime 24 時間制 (hh:mm) で時刻を表示します。

適用対象

こちらもご覧ください