Strings.FormatDateTime(DateTime, DateFormat) Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.Core.dll
Ensamblado:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Devuelve una expresión de cadena que representa un valor de fecha u hora.

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

Parámetros

Expression
DateTime

Obligatorio. Expresión de Date a la que se va a aplicar formato.

NamedFormat
DateFormat

Opcional. Valor numérico que indica el formato de fecha y hora utilizado. Si se omite, se utiliza DateFormat.GeneralDate.

Devoluciones

String

Expresión de cadena que representa un valor de fecha u hora.

Excepciones

ArgumentException

El valor de NamedFormat no es válido.

Ejemplos

En este ejemplo se muestra el uso de la FormatDateTime función .

' 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)

Comentarios

El Date tipo de datos siempre contiene información de fecha y hora. Para fines de conversión de tipos, Visual Basic considera que el 1/1/1 de enero del año 1 es un valor neutro para la fecha y 00:00:00 (medianoche) es un valor neutro para la hora. Si da formato a un Date valor como una cadena de fecha y hora, FormatDateTime no incluye valores neutros en la cadena resultante. Por ejemplo, si convierte #1/1/0001 9:30:00# en una cadena, el resultado es "9:30:00 AM"; se suprime la información de fecha. Sin embargo, la información de fecha sigue presente en el valor Date original y se puede recuperar con funciones como DatePart.

Nota

Si pasa el Expression argumento como literal String , FormatDateTime lo interpreta según la configuración de la CurrentCulture aplicación. Sin embargo, si se pasa como literal Date , use el formato #mm/dd/aaaa#, ya que FormatDateTime siempre interpreta un Date literal según la referencia cultural inglés (EE. UU.). Esto es necesario porque, si una aplicación se desarrolla y codifica mediante Date literales de una referencia cultural, pero se ejecuta en una plataforma con una referencia cultural diferente, los Date literales se podrían analizar incorrectamente.

El NamedFormat argumento tiene la siguiente configuración.

Constante Descripción
DateFormat.GeneralDate Muestra una fecha o hora. Muestra una parte de fecha como una fecha corta. Si hay una parte de tiempo, mostrándola como mucho tiempo. Si está presente, se muestran ambas partes.
DateFormat.LongDate Muestra una fecha con el formato de fecha larga especificado en la configuración regional del equipo.
DateFormat.ShortDate Muestra una fecha con el formato de fecha corta especificado en la configuración regional del equipo.
DateFormat.LongTime Muestra una hora con el formato de hora especificado en la configuración regional del equipo.
DateFormat.ShortTime Mostrar una hora con el formato de 24 horas (hh:mm).

Se aplica a

Consulte también