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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Compartir vía