Strings.FormatDateTime(DateTime, DateFormat) Strings.FormatDateTime(DateTime, DateFormat) Strings.FormatDateTime(DateTime, DateFormat) Method

Definición

Devuelve una expresión de cadena que representa un valor de fecha u hora.Returns a string expression representing a date/time value.

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 DateTime DateTime

Obligatorio.Required. Expresión de Date a la que se va a aplicar formato.Date expression to be formatted.

NamedFormat
DateFormat DateFormat DateFormat

Opcional.Optional. Valor numérico que indica el formato de fecha y hora utilizado.Numeric value that indicates the date/time format used. Si se omite, se utiliza DateFormat.GeneralDate.If omitted, DateFormat.GeneralDate is used.

Devoluciones

Expresión de cadena que representa un valor de fecha u hora.A string expression representing a date/time value.

Excepciones

El valor de NamedFormat no es válido.NamedFormat setting is not valid.

Ejemplos

En este ejemplo se muestra el uso de la FormatDateTime función.This example demonstrates the use of the FormatDateTime function.

' 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.The Date data type always contains both date and time information. Para fines de conversión de tipos, Visual Basic considera 1/1/1 (1 de enero del año 1) tenga un valor neutro para que la fecha y 00:00:00 (medianoche) como un valor neutro por vez.For purposes of type conversion, Visual Basic considers 1/1/1 (January 1 of the year 1) to be a neutral value for the date, and 00:00:00 (midnight) to be a neutral value for the time. Si aplica formato a un Date valor como una cadena de fecha y hora, FormatDateTime no incluye valores neutrales en la cadena resultante.If you format a Date value as a date/time string, FormatDateTime does not include neutral values in the resulting string. 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.For example, if you convert #1/1/0001 9:30:00# to a string, the result is "9:30:00 AM"; the date information is suppressed. Sin embargo, la información de fecha aún está presente en el original Date valor y se pueden recuperar con funciones como DatePart.However, the date information is still present in the original Date value and can be recovered with functions such as DatePart.

Nota

Si se pasa el Expression argumento como un String literal, FormatDateTime lo interpreta según el CurrentCulture configuración de la aplicación.If you pass the Expression argument as a String literal, FormatDateTime interprets it according to the CurrentCulture setting of your application. Sin embargo, si se pasa como un Date literal, utilice el formato #mm/dd/aaaa #, porque FormatDateTime siempre interpreta un Date literal según la referencia cultural de inglés (Estados Unidos).However, if you pass it as a Date literal, use the format #mm/dd/yyyy#, because FormatDateTime always interprets a Date literal according to the English (US) culture. Esto es necesario porque, si una aplicación se desarrolla y codifica con Date literales de una referencia cultural, pero, a continuación, se ejecuta en una plataforma con una referencia cultural diferente, el Date literales se podrían analizar correctamente.This is necessary because, if an application is developed and coded using Date literals from one culture, but is then executed on a platform with a different culture, the Date literals could be parsed incorrectly.

El NamedFormat argumento tiene las siguientes opciones.The NamedFormat argument has the following settings.

ConstanteConstant DescripciónDescription
DateFormat.GeneralDate Mostrar una fecha u hora.Display a date and/or time. Mostrar una parte de fecha como una fecha corta.Display a date part as a short date. Si hay una parte horaria, mostrarlo como mucho tiempo.If there is a time part, display it as a long time. Si está presente, se muestran ambas partes.If present, both parts display.
DateFormat.LongDate Mostrar una fecha con el formato de fecha larga especificado en la configuración regional del equipo.Display a date using the long date format specified in your computer's regional settings.
DateFormat.ShortDate Mostrar una fecha con el formato de fecha corta especificado en la configuración regional del equipo.Display a date using the short date format specified in your computer's regional settings.
DateFormat.LongTime Muestra una hora con el formato de hora especificado en la configuración regional del equipo.Display a time using the time format specified in your computer's regional settings.
DateFormat.ShortTime Muestra una hora con el formato de 24 horas (hh: mm).Display a time using the 24-hour format (hh:mm).

Se aplica a

Consulte también: