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 FormatDateTime de la 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. A efectos de la conversión de tipos, Visual Basic considera 1/1/1 (1 de enero del año 1) para que sea un valor neutro para la fecha y 00:00:00 (medianoche) como valor neutro para el tiempo.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 se da formato Date a un valor como una cadena de fecha FormatDateTime y hora, no se incluyen los valores neutros 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 todavía está presente en Date el valor original y se puede recuperar con funciones DatePartcomo.However, the date information is still present in the original Date value and can be recovered with functions such as DatePart.

Nota

Si pasa el Expression argumento como un String literal, FormatDateTime lo interpreta de acuerdo con la 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 lo pasa como un Date literal, use el formato #mm/DD/YYYY #, porque FormatDateTime siempre interpreta un Date literal según la referencia cultural inglés (EE. UU.).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 utilizando Date literales de una referencia cultural, pero se ejecuta en una plataforma con una referencia cultural diferente, los Date literales podrían analizarse incorrectamente.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 la siguiente configuración.The NamedFormat argument has the following settings.

ConstanteConstant DescripciónDescription
DateFormat.GeneralDate Mostrar una fecha o una hora.Display a date and/or time. Muestra una parte de la fecha como una fecha corta.Display a date part as a short date. Si hay una parte de la hora, se muestra como una hora larga.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 Muestra 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 Muestra 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: