datetime.h

Clase wxDateTime

La clase wxDateTime representa un momento absoluto en el tiempo.

El tipo wxDateTime_t está tipificado como unsigned short y se utiliza para contener el número de años, horas, minutos, segundos y milisegundos.

Se define la constante global wxDefaultDateTime y su sinónimo wxInvalidDateTime. Esta constante será diferente de cualquier objeto wxDateTime válido.

Funciones estáticas

Todas las funciones estáticas establecen o devuelven las variables estáticas de wxDateSpan (el calendario), devuelven el momento actual, año, mes o número de días en él, o realizan algunas acciones generales relacionadas con el calendario.

Hay que tener en cuenta que aunque varias funciones aceptan un parámetro Calendar extra, actualmente se ignora ya que sólo se soporta el calendario gregoriano. Futuras versiones soportarán otros calendarios.

Formateo y análisis sintáctico de fechas

Las funciones de formateo y análisis sintáctico de fechas convierten objetos wxDateTime a y desde texto. Las conversiones a texto son en su mayoría triviales: puede hacerlo utilizando las representaciones de fecha y hora por defecto para la configuración regional actual (FormatDate() y FormatTime()), utilizando la representación estándar internacional definida por ISO 8601 (FormatISODate(), FormatISOTime() y FormatISOCombined()) o especificando cualquier formato y utilizando Format() directamente.

Las conversiones a partir de texto son más interesantes, ya que hay muchas más posibilidades de las que ocuparse. Los casos más simples se pueden tratar con ParseFormat() que puede analizar cualquier fecha en el formato (rígido) dado. ParseRfc822Date() es otra función para analizar fechas en un formato predefinido - el del RFC 822 que (todavía...) define el formato de los mensajes de correo electrónico en Internet. Este formato no puede describirse con cadenas de formato similares a strptime(3) utilizadas por Format(), de ahí la necesidad de una función separada.

Pero las funciones más interesantes son ParseTime(), ParseDate() y ParseDateTime(). Intentan analizar la fecha y la hora (o sólo una de ellas) en formato "libre", es decir, permiten especificarlas de cualquiera de las formas posibles. Estas funciones se utilizarán normalmente para analizar la entrada (interactiva) del usuario que no está obligada a estar en ningún formato predefinido. Por ejemplo, ParseDate() puede analizar cadenas como "mañana2, "el 1 de marzo" e incluso "el próximo domingo".

Por último, observar que cada una de las funciones de análisis está disponible en varias sobrecargas: si la cadena de entrada es una cadena estrecha (char *), se devuelve un puntero estrecho. Si la cadena de entrada es una cadena ancha, se devuelve un puntero char ancho. Por último, si el parámetro de entrada es una cadena wxString, también se devuelve un puntero char estrecho por compatibilidad con versiones anteriores, pero también hay un argumento adicional de tipo wxString::const_iterator en el que, si no es nullptr, se devuelve un iterador que apunta al final de la parte de la cadena analizada.

Clases

NameForm()

class NameForm

NameForm.

TimeZone()

class TimeZone

TimeZone.

Tm()

struct Tm

Tm.

Tipos

wxDateTime_t

typedef unsigned short wxDateTime::wxDateTime_t

Un pequeño tipo entero sin signo para almacenar cosas como minutos, segundos, etc.

Debe ser al menos corto (es decir, no char) para contener el número de milisegundos - también puede ser 'int' porque no hay ninguna penalización de tamaño asociada a él en nuestro código, no almacenamos ningún dato en este formato.

Calendar

enum wxDateTime::Calendar

    enum Calendar
    {
        Gregorian,  // current calendar
        Julian      // calendar in use since -45 until the 1582 (or later)
    };

Varias funciones aceptan un parámetro adicional que especifica el calendario a utilizar (aunque la mayoría de ellas sólo admiten ahora el calendario gregoriano).

Este parámetro es uno de los siguientes valores:

Gregoriano: Calendario utilizado actualmente en los países occidentales.
Juliano: Calendario en uso desde -45 hasta el 1582 (o después)

Country

enum wxDateTime::Country

    enum Country
    {
        Country_Unknown, // no special information for this country
        Country_Default, // set the default country with SetCountry() method
                         // or use the default country with any other
        Country_WesternEurope_Start,
        Country_EEC = Country_WesternEurope_Start,
        France,
        Germany,
        UK,
        Country_WesternEurope_End = UK,
        Russia,
        USA
    };

Los cálculos de fecha a menudo dependen del país y wxDateTime permite establecer el país cuyas convenciones deben utilizarse utilizando SetCountry().

Toma como parámetro uno de los siguientes valores:

Country_Unknown: No hay información especial para este país.
Country_Default: Establezar el país por defecto con el método SetCountry() o utilizar el país por defecto con cualquier otro.
Country_WesternEurope_Start
Country_EEC
France
Germany
UK
Country_WesternEurope_End
Russia
USA

Month

enum wxDateTime::Month

    enum Month
    {
        Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec, Inv_Month
    };

Nombres simbólicos de los meses:

Enero
Feb
Mar
Abr
Mayo
Jun
Jul
Ago
Sep
Oct
Nov
Dic
Inv_Month: Valor de mes no válido.

NameContext

enum wxDateTime::NameContext

Contexto para el uso de nombres en las funciones GetWeekDayName() y GetMonthName().

Context_Formatting: Nombre para uso en contexto de formateo de fecha.
Context_Standalone: Nombre para su uso en contexto independiente.

NameFlags

enum wxDateTime::NameFlags

Indicadores que se utilizarán con las funciones GetMonthName() y GetWeekDayName().

Name_Full: Devuelve el nombre completo.
Name_Abbr: Devuelve el nombre abreviado.
Name_Shortest: Devuelve el nombre más corto Disponible desde la versión 3.3.0 de wxWidgets.

TZ

enum wxDateTime::TZ

    enum TZ
    {
        // the time in the current time zone
        Local,

        // zones from GMT (= Greenwich Mean Time): they're guaranteed to be
        // consequent numbers, so writing something like `GMT0 + offset' is
        // safe if abs(offset) <= 12

        // underscore stands for minus
        GMT_12, GMT_11, GMT_10, GMT_9, GMT_8, GMT_7,
        GMT_6, GMT_5, GMT_4, GMT_3, GMT_2, GMT_1,
        GMT0,
        GMT1, GMT2, GMT3, GMT4, GMT5, GMT6,
        GMT7, GMT8, GMT9, GMT10, GMT11, GMT12, GMT13,
        // Note that GMT12 and GMT_12 are not the same: there is a difference
        // of exactly one day between them

        // some symbolic names for TZ

        // Europe
        WET = GMT0,                         // Western Europe Time
        WEST = GMT1,                        // Western Europe Summer Time
        CET = GMT1,                         // Central Europe Time
        CEST = GMT2,                        // Central Europe Summer Time
        EET = GMT2,                         // Eastern Europe Time
        EEST = GMT3,                        // Eastern Europe Summer Time
        MSK = GMT3,                         // Moscow Time
        MSD = GMT4,                         // Moscow Summer Time

        // US and Canada
        AST = GMT_4,                        // Atlantic Standard Time
        ADT = GMT_3,                        // Atlantic Daylight Time
        EST = GMT_5,                        // Eastern Standard Time
        EDT = GMT_4,                        // Eastern Daylight Saving Time
        CST = GMT_6,                        // Central Standard Time
        CDT = GMT_5,                        // Central Daylight Saving Time
        MST = GMT_7,                        // Mountain Standard Time
        MDT = GMT_6,                        // Mountain Daylight Saving Time
        PST = GMT_8,                        // Pacific Standard Time
        PDT = GMT_7,                        // Pacific Daylight Saving Time
        HST = GMT_10,                       // Hawaiian Standard Time
        AKST = GMT_9,                       // Alaska Standard Time
        AKDT = GMT_8,                       // Alaska Daylight Saving Time

        // Australia

        A_WST = GMT8,                       // Western Standard Time
        A_CST = GMT13 + 1,                  // Central Standard Time (+9.5)
        A_EST = GMT10,                      // Eastern Standard Time
        A_ESST = GMT11,                     // Eastern Summer Time

        // New Zealand
        NZST = GMT12,                       // Standard Time
        NZDT = GMT13,                       // Daylight Saving Time

        // TODO add more symbolic timezone names here

        // Universal Coordinated Time = the new and politically correct name
        // for GMT
        UTC = GMT0
    };

Nombres simbólicos de zonas horarias.

Local: La hora en la zona horaria actual.
GMT_12: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_11: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_10: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_9: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_8: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_7: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_6: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_5: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_4: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_3: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_2: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT_1: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT0: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT1: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT2: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT3: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT4: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT5: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT6: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT7: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT8: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT9: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT10: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT11: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT12: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
GMT13: Zonas desde GMT (= Greenwich Mean Time): se garantiza que son números consecuentes, por lo que escribir algo como GMT0 + offset es seguro si abs(offset) <= 12
WET: Hora de Europa Occidental.
WEST: Horario de verano de Europa Occidental.
CET: Hora de Europa Central.
CEST: Horario de verano de Europa Central.
EET: Hora de Europa del Este.
EEST: Hora de verano de Europa Oriental.
MSK: Hora de Moscú.
MSD: Horario de verano de Moscú.
AST: Hora estándar del Atlántico.
ADT: Hora de verano del Atlántico.
EST: Hora estándar del Este.
EDT: Horario de verano del Este.
CST: Hora central estándar.
CDT: Horario central de verano.
MST: Hora estándar de montaña.
MDT: Horario de verano de montaña.
PST: Hora estándar del Pacífico.
PDT: Horario de verano del Pacífico.
HST: Hora estándar de Hawai.
AKST: Hora estándar de Alaska.
AKDT: Horario de verano de Alaska.
A_WST: Hora estándar del Oeste.
A_CST: Hora estándar central (+9,5)
A_EST: Hora estándar del Este.
A_ESST: Horario de verano del Este.
NZST: Hora estándar.
NZDT: Horario de verano.
UTC: Tiempo universal coordinado.

WeekDay()

enum wxDateTime::WeekDay

    enum WeekDay
    {
        Sun, Mon, Tue, Wed, Thu, Fri, Sat, Inv_WeekDay
    };

Nombres simbólicos de los días de la semana.

Sun
Mon
Tue
Wed
Thu
Fri
Sat
Inv_WeekDay: Valor de día de la semana no válido.

WeekFlags()

enum wxDateTime::WeekFlags

    enum WeekFlags
    {
        Default_First,   // Sunday_First for US, Monday_First for the rest
        Monday_First,    // week starts with a Monday
        Sunday_First     // week starts with a Sunday
    };

En distintas partes del mundo se utilizan diferentes convenciones para el inicio de la semana.

En algunos países, la semana comienza el domingo, mientras que en otros, el lunes. La norma ISO no aborda esta cuestión, por lo que admitimos ambas convenciones en las funciones cuyo resultado depende de ella (GetWeekOfYear() y GetWeekOfMonth()).

El comportamiento deseado puede especificarse dando una de las siguientes constantes como argumento a estas funciones.

Default_First: Sunday_First para EE.UU., Monday_First para el resto.
Monday_First: La semana empieza en lunes.
Sunday_First: La semana empieza en domingo.

Year()

enum wxDateTime::Year

    enum Year
    {
        Inv_Year = SHRT_MIN    // should hold in wxDateTime_t
    };

Valor no válido para el año. Inv_Year.

Funciones miembro

wxDateTime()

wxDateTime::wxDateTime()

Constructor por defecto.

Utilizar una de las funciones Set() para inicializar el objeto más tarde.

wxDateTime()

wxDateTime::wxDateTime(const wxDateTime & date)

Constructor copia.

wxDateTime()

wxDateTime::wxDateTime(time_t timet)

Lo mismo que Set().

wxDateTime()

wxDateTime::wxDateTime(const struct tm & tm)

Lo mismo que Set().

wxDateTime()

wxDateTime::wxDateTime(double jdn)

Lo mismo que Set().

wxDateTime()

wxDateTime::wxDateTime( wxDateTime_t hour, wxDateTime_t minute = 0, wxDateTime_t second = 0, wxDateTime_t millisec = 0 )

Lo mismo que Set().

wxDateTime()

wxDateTime::wxDateTime( wxDateTime_t day, Month month, int year = Inv_Year, wxDateTime_t hour = 0, wxDateTime_t minute = 0, wxDateTime_t second = 0, wxDateTime_t millisec = 0 )

Lo mismo que Set().

wxDateTime()

wxDateTime::wxDateTime(const struct _SYSTEMTIME & st)

Igual que SetFromMSWSysTime.

Parámetros

st: Entrada, referencia SYSTEMTIME de Windows

Add()

wxDateTime& wxDateTime::Add(const wxDateSpan & diff)

Añade el intervalo de fechas dado a este objeto.

Add()

wxDateTime wxDateTime::Add(const wxDateSpan & diff) const

Añade el intervalo de fechas dado a este objeto.

Add()

wxDateTime& wxDateTime::Add(const wxTimeSpan & diff)

Añade el intervalo de fechas dado a este objeto.

Add()

wxDateTime wxDateTime::Add(const wxTimeSpan & diff) const

Añade el intervalo de fechas dado a este objeto.

ConvertYearToBC()

static int wxDateTime::ConvertYearToBC(int year)

Convierte el año en notación absoluta (es decir, un número que puede ser negativo, positivo o cero) al año en notación BC/AD.

Para los años positivos no se hace nada, pero el año 0 es el año 1 a.C. y por tanto para los demás años hay una diferencia de 1.

Esta función debe utilizarse así:

wxDateTime dt(...);
int y = dt.GetYear();
printf("The year is %d%s", wxDateTime::ConvertYearToBC(y), y > 0 ? "AD" : "BC");

DiffAsDateSpan()

wxDateSpan wxDateTime::DiffAsDateSpan(const wxDateTime & dt) const

Devuelve la diferencia entre este objeto y dt como un wxDateSpan.

Este método permite encontrar el número de años, meses, semanas y días enteros entre dt y esta fecha.

Format()

wxString wxDateTime::Format( const wxString & format = wxDefaultDateTimeFormat, const TimeZone & tz = Local ) const

Esta función hace lo mismo que la función estándar ANSI C strftime(3) (https://cplusplus.com/reference/ctime/strftime/).

Consultar su descripción para conocer el significado del parámetro format.

Hay que tener en cuenta que los especificadores de formato POSIX "%g", "%G", "%V" y "%z" están soportados incluso si la biblioteca estándar no los soporta (por ejemplo, MSVC).

También acepta algunas extensiones específicas de wxWidgets: opcionalmente se puede especificar el ancho del campo a seguir utilizando una sintaxis similar a printf(3) y la especificación de formato "%l" se puede utilizar para obtener el número de milisegundos.

FormatDate()

wxString wxDateTime::FormatDate() const

Idéntico a llamar a Format() con el argumento "%x" (que significa "representación de fecha preferida para la configuración regional actual").

FormatISOCombined()

wxString wxDateTime::FormatISOCombined(char sep = 'T') const

Devuelve la representación combinada fecha-hora en el formato ISO 8601 "AAAA-MM-DDTHH:MM:SS".

El valor predeterminado del parámetro sep produce el resultado que corresponde exactamente a la norma ISO, pero también puede ser útil utilizar un espacio como separador si se necesita una representación combinada de fecha y hora más legible para las personas.

FormatISODate()

wxString wxDateTime::FormatISODate() const

Esta función devuelve la representación de la fecha en el formato ISO 8601 "AAAA-MM-DD".

FormatISOTime()

wxString wxDateTime::FormatISOTime() const

Esta función devuelve la representación de la hora en el formato ISO 8601 "HH:MM:SS".

FormatTime()

wxString wxDateTime::FormatTime() const

Idéntico a llamar a Format() con el argumento "%X" (que significa "representación horaria preferida para la configuración regional actual").

FromTimezone()

wxDateTime wxDateTime::FromTimezone( const TimeZone & tz, bool noDST = false ) const

Transforma la fecha de la zona horaria dada a la local.

Si noDST es verdadero, no se realizará ningún ajuste DST.

Si el parámetro tz es wxDateTime::Local, no se realizará ningún ajuste.

Valor de retorno

La fecha ajustada por la diferencia entre la zona horaria dada y la local.

GetAmPmStrings()

static void wxDateTime::GetAmPmStrings( wxString * am, wxString * pm )

Devuelve las traducciones de las cadenas AM y PM utilizadas para el formato de la hora para la configuración regional actual.

Cualquiera de los punteros puede ser NULL si no se necesita el valor correspondiente.

GetAsDOS()

unsigned long wxDateTime::GetAsDOS() const

Devuelve la fecha y la hora en formato DOS.

GetAsMSWSysTime()

void wxDateTime::GetAsMSWSysTime(struct _SYSTEMTIME * st) const

Devuelve la fecha y la hora en el formato SYSTEMTIME de Windows.

Parámetros

st: Salida, puntero a SYSTEMTIME de Windows

Observaciones

Sólo MSW.

GetBeginDST()

static wxDateTime wxDateTime::GetBeginDST( int year = Inv_Year, Country country = Country_Default )

Obtiene el inicio del horario de verano para el país dado en el año dado (el actual por defecto).

Esta función adolece de las limitaciones descritas en la descripción general de DST.

GetCentury()

int wxDateTime::GetCentury(const TimeZone & tz = Local) const

Devuelve el siglo de esta fecha.

GetCentury()

static int wxDateTime::GetCentury(int year)

Obtiene el siglo actual, es decir, los dos primeros dígitos del año, en el calendario dado (actualmente sólo se admite el gregoriano).

GetCountry()

static Country wxDateTime::GetCountry()

Devuelve el país actual por defecto.

El país por defecto se utiliza para los cálculos DST, por ejemplo.

GetCurrentMonth()

static Month wxDateTime::GetCurrentMonth(Calendar cal = Gregorian)

Obtiene el mes actual en el calendario dado (actualmente sólo se admite el gregoriano).

GetCurrentYear()

static int wxDateTime::GetCurrentYear(Calendar cal = Gregorian)

Obtiene el año actual en el calendario dado (actualmente sólo se admite el gregoriano).

GetDateOnly()

wxDateTime wxDateTime::GetDateOnly() const

Devuelve el objeto que tiene el mismo componente de fecha que éste pero hora de 00:00:00.

GetDay()

unsigned short wxDateTime::GetDay(const TimeZone & tz = Local) const

Devuelve el día en la zona horaria dada (la local por defecto).

GetDayOfYear()

unsigned short wxDateTime::GetDayOfYear(const TimeZone & tz = Local) const

Devuelve el día del año (en el rango 1-366) en la zona horaria dada (la local por defecto).

GetEndDST()

static wxDateTime wxDateTime::GetEndDST( int year = Inv_Year, Country country = Country_Default )

Devuelve el final del horario de verano para el país dado en el año dado (el actual por defecto).

GetEnglishMonthName()

static wxString wxDateTime::GetEnglishMonthName( Month month, NameFlags flags = Name_Full )

Devuelve el nombre en inglés estándar del mes dado.

Esta función siempre devuelve "January" o "Jan" para enero, utilizar GetMonthName() para recuperar el nombre del mes en la configuración regional actual del usuario.

Parámetros

month: Uno de los valores wxDateTime::Jan, ..., wxDateTime::Dec.
flags: Name_Full (por defecto) o Name_Abbr.

GetEnglishWeekDayName()

static wxString wxDateTime::GetEnglishWeekDayName( WeekDay weekday, NameFlags flags = Name_Full )

Devuelve el nombre en inglés estándar del día de la semana dado.

Esta función siempre devuelve "Monday" o "Mon" para el lunes, utilizar GetWeekDayName() para recuperar el nombre del mes en la configuración regional actual del usuario.

Parámetros

weekday: Uno de los valores wxDateTime::Sun, ..., wxDateTime::Sat.
flags: Name_Full (por defecto) o Name_Abbr.

GetFirstWeekDay()

static bool wxDateTime::GetFirstWeekDay(WeekDay * firstDay)

Obtiene el primer día de la semana en función de la configuración regional y/o del sistema operativo.

Si la información no está disponible, devuelve "Sun".

Parámetros

firstDay: Dirección de una variable WeekDay a la que se asignará el primer día de la semana.

Valor de retorno

Si no se ha podido determinar el primer día, devuelve false, y firstDay se establece en un valor alternativo.

GetHour()

unsigned short wxDateTime::GetHour(const TimeZone & tz = Local) const

Devuelve la hora en la zona horaria dada (la local por defecto).

GetJDN()

double wxDateTime::GetJDN() const

Sinónimo de GetJulianDayNumber().

GetJulianDayNumber()

double wxDateTime::GetJulianDayNumber() const

Devuelve el número del día Juliano correspondiente a esta fecha.

¡Cuidado con los errores de redondeo!

GetLastMonthDay()

wxDateTime wxDateTime::GetLastMonthDay( Month month = Inv_Month, int year = Inv_Year ) const

Devuelve la copia de este objeto a la que se aplicó SetToLastMonthDay().

GetLastWeekDay()

wxDateTime wxDateTime::GetLastWeekDay( WeekDay weekday, Month month = Inv_Month, int year = Inv_Year )

Devuelve la copia de este objeto a la que se aplicó SetToLastWeekDay().

GetMillisecond()

unsigned short wxDateTime::GetMillisecond(const TimeZone & tz = Local) const

Devuelve los milisegundos en la zona horaria dada (la local por defecto).

GetMinute()

unsigned short wxDateTime::GetMinute(const TimeZone & tz = Local) const

Devuelve el minuto en la zona horaria dada (la local por defecto).

GetMJD()

double wxDateTime::GetMJD() const

Sinónimo de GetModifiedJulianDayNumber().

GetModifiedJulianDayNumber()

double wxDateTime::GetModifiedJulianDayNumber() const

Devuelve el "Número de Día Juliano Modificado" (MJD) que es, por definición, igual a JDN - 2400000.5.

Los MJD son más sencillos de trabajar ya que los MJD integrales corresponden a los mediodías de las fechas del calendario gregoriano y no a los mediodías como JDN. El MJD 0 representa el 17 de noviembre de 1858.

GetMonth()

Month wxDateTime::GetMonth(const TimeZone & tz = Local) const

Devuelve el mes en la zona horaria dada (la local por defecto).

GetMonthName()

static wxString wxDateTime::GetMonthName( Month month, NameFlags flags = Name_Full )

Obtiene el nombre completo (por defecto) o abreviado del mes dado.

Esta función devuelve el nombre en la configuración regional actual, utilizar GetEnglishMonthName() para obtener el nombre sin traducir si es necesario.

Parámetros

month: Uno de los valores wxDateTime::Jan, ..., wxDateTime::Dec.
flags: Name_Full (por defecto) o Name_Abbr.

GetNextWeekDay()

wxDateTime wxDateTime::GetNextWeekDay(WeekDay weekday) const

Devuelve la copia de este objeto a la que se aplicó SetToNextWeekDay().

GetNumberOfDays()

static wxDateTime_t wxDateTime::GetNumberOfDays( int year, Calendar cal = Gregorian )

Devuelve el número de días del año dado.

El único valor admitido actualmente para cal es el gregoriano.

wxDateTime_t()

static wxDateTime_t wxDateTime::wxDateTime_t( Month month, int year = Inv_Year, Calendar cal = Gregorian )

Devuelve el número de días en el mes dado del año dado.

El único valor admitido actualmente para cal es el gregoriano.

GetPrevWeekDay()

wxDateTime wxDateTime::GetPrevWeekDay(WeekDay weekday) const

Devuelve la copia de este objeto a la que se aplicó SetToPrevWeekDay().

GetRataDie()

double wxDateTime::GetRataDie() const

Devuelve el número Rata Die de esta fecha.

Por definición, el número Rata Die es una fecha especificada como el número de días relativos a una fecha base del 31 de diciembre del año 0. Así, el 1 de enero del año 1 es el día Rata Die 1.

GetSecond()

unsigned short wxDateTime::GetSecond(const TimeZone & tz = Local) const

Devuelve los segundos en la zona horaria dada (la local por defecto).

GetTicks()

time_t wxDateTime::GetTicks() const

Devuelve el número de segundos transcurridos desde el 1 de enero de 1970 UTC.

Esta función se proporciona únicamente para la interoperabilidad con la biblioteca estándar de C y otras bibliotecas que utilizan valores time_t. Si sólo se necesita obtener el valor representado por este objeto como un número, utilizar GetValue() en su lugar, que no pierde precisión y cubre todo el rango de fechas soportado, a diferencia de ésta que está limitada al rango de valores positivos de 32 bits, es decir, desde el 1 de enero de 1970 hasta alrededor del 19 de enero de 2038 y devuelve -1 para las fechas fuera de él.

Además, este método debe invocarse sobre un objeto fecha inicializado y se produce un fallo de aserción si se invoca sobre un objeto para el que IsValid() es falso.

GetTimeNow()

static time_t wxDateTime::GetTimeNow()

Devuelve la hora actual.

GetTm()

Tm wxDateTime::GetTm(const TimeZone & tz = Local) const

Devuelve una representación desglosada de la fecha y la hora.

GetTmNow()

static tm* wxDateTime::GetTmNow()

Devuelve la hora actual desglosada.

Hay que tener en cuenta que esta función devuelve un puntero a un búfer estático que es reutilizado por las llamadas a esta función y ciertas funciones de la biblioteca C (por ejemplo, localtime). Si existe alguna posibilidad de que su código se utilice en una aplicación multihilo, se debería utilizar GetTmNow(struct tm *) en su lugar.

GetTmNow()

static tm* wxDateTime::GetTmNow(struct tm * tm)

Devuelve la hora actual desglosada utilizando el buffer cuya dirección se pasa a la función con tm para almacenar el resultado.

GetValue()

wxLongLong wxDateTime::GetValue() const

Devuelve el número de milisegundos desde el 1 de enero de 1970 UTC.

Devuelve directamente la representación interna del objeto wxDateTime como el número de milisegundos (positivos o negativos) desde la época Unix/C.

GetWeekBasedYear()

int wxDateTime::GetWeekBasedYear(const TimeZone & tz) const

Devuelve el año al que pertenece la semana que contiene esta fecha.

El valor devuelto por esta función es el mismo que el año, excepto, posiblemente, para unos pocos días al principio y al final del año si pertenecen a una semana que en su mayor parte (es decir, al menos 4 días) pertenece a otro año, en cuyo caso se devuelve ese otro año (anterior o siguiente).

Por ejemplo, el 1 de enero de 2015 pertenece al primer año de 2015, por lo que GetWeekOfYear() devuelve 1 y esta función devuelve 2015. Sin embargo, el 1 de enero de 2016 pertenece a la última semana de 2015 según las normas ISO 8601, por lo que GetWeekOfYear() devuelve 53 y esta función devuelve 2015, aunque GetYear() devuelve 2016.

GetWeekDay()

WeekDay wxDateTime::GetWeekDay(const TimeZone & tz = Local) const

Devuelve el día de la semana en la zona horaria dada (la local por defecto).

GetWeekDay()

wxDateTime wxDateTime::GetWeekDay( WeekDay weekday, int n = 1, Month month = Inv_Month, int year = Inv_Year ) const

Devuelve la copia de este objeto a la que se aplicó SetToWeekDay().

GetWeekDayInSameWeek()

wxDateTime wxDateTime::GetWeekDayInSameWeek( WeekDay weekday, WeekFlags flags = Monday_First ) const

Devuelve la copia de este objeto a la que se aplicó SetToWeekDayInSameWeek().

GetWeekDayName()

static wxString wxDateTime::GetWeekDayName( WeekDay weekday, NameForm form = {} )

Obtiene el nombre completo (por defecto), abreviado o más corto del día de la semana dado.

Esta función devuelve el nombre en la configuración regional actual, utilizar GetEnglishWeekDayName() para obtener el nombre sin traducir si es necesario.

Parámetros

weekday: Uno de los valores wxDateTime::Sun, ..., wxDateTime::Sat.
form: Forma del nombre consistente en las banderas (Name_Full, Name_Abbr, o Name_Shortest) y el contexto (Context_Formatting o Context_Standalone) El valor por defecto es Name_Full en Context_Formatting. Ejemplo: wxNameForm().Abbr().Standalone()

GetWeekOfMonth()

wxDateTime_t wxDateTime::GetWeekOfMonth( WeekFlags flags = Monday_First, const TimeZone & tz = Local ) const

Devuelve el número ordinal de la semana del mes (en el rango 1-5).

Al igual que GetWeekOfYear(), esta función admite ambas convenciones para el inicio de la semana.

GetWeekOfYear()

wxDateTime_t wxDateTime::GetWeekOfYear( WeekFlags flags = Monday_First, const TimeZone & tz = Local ) const

Devuelve el número de la semana del año en que se encuentra esta fecha.

La primera semana del año es, según las normas internacionales, la que contiene el 4 de enero o, equivalentemente, la primera semana que tiene jueves en este año. Ambas definiciones equivalen a decir que la primera semana del año debe contener más de la mitad de sus días en este año. En consecuencia, el número de la semana siempre estará en el rango 1-53 (52 para los años no bisiestos).

La función depende de la convención de inicio de semana especificada por el argumento flags, pero sus resultados para Sunday_First no están bien definidos, ya que la definición ISO citada anteriormente sólo se aplica a las semanas que empiezan en lunes.

GetYear()

int wxDateTime::GetYear(const TimeZone & tz = Local) const

Devuelve el año en la zona horaria dada (la local por defecto).

GetYearDay()

wxDateTime wxDateTime::GetYearDay(wxDateTime_t yday) const

Devuelve la copia de este objeto a la que se aplicó SetToYearDay().

IsBetween()

bool wxDateTime::IsBetween( const wxDateTime & t1, const wxDateTime & t2 ) const

Devuelve verdadero si IsStrictlyBetween() es verdadero o si la fecha es igual a uno de los valores límite.

IsDST()

int wxDateTime::IsDST(Country country = Country_Default) const

Devuelve true si se aplica el horario de verano para esta fecha en el país dado.

IsDSTApplicable()

static bool wxDateTime::IsDSTApplicable( int year = Inv_Year, Country country = Country_Default )

Devuelve true si se utilizó DST en el año dado (el actual por defecto) en el país dado.

IsEarlierThan()

bool wxDateTime::IsEarlierThan(const wxDateTime & datetime) const

Devuelve true si esta fecha es anterior a la dada.

IsEqualTo()

bool wxDateTime::IsEqualTo(const wxDateTime & datetime) const

Devuelve verdadero si las dos fechas son estrictamente idénticas.

IsEqualUpTo()

bool wxDateTime::IsEqualUpTo( const wxDateTime & dt, const wxTimeSpan & ts ) const

Devuelve verdadero si la fecha es igual a otra hasta el intervalo de tiempo dado, es decir, si la diferencia absoluta entre las dos fechas es menor que este intervalo.

IsLaterThan()

bool wxDateTime::IsLaterThan(const wxDateTime & datetime) const

Devuelve true si esta fecha es posterior a la dada.

IsLeapYear()

static bool wxDateTime::IsLeapYear( int year = Inv_Year, Calendar cal = Gregorian )

Devuelve verdadero si el año es bisiesto en el calendario especificado.

Esta función admite los calendarios gregoriano y juliano.

IsSameDate()

bool wxDateTime::IsSameDate(const wxDateTime & dt) const

Devuelve true si la fecha es la misma sin comparar las partes de tiempo.

IsSameTime()

bool wxDateTime::IsSameTime(const wxDateTime & dt) const

Devuelve verdadero si la hora es la misma (aunque las fechas puedan diferir).

IsStrictlyBetween()

bool wxDateTime::IsStrictlyBetween( const wxDateTime & t1, const wxDateTime & t2 ) const

Devuelve verdadero si esta fecha se encuentra estrictamente entre las dos fechas dadas.

IsValid()

bool wxDateTime::IsValid() const

Devuelve true si el objeto representa un momento temporal válido.

IsWestEuropeanCountry()

static bool wxDateTime::IsWestEuropeanCountry(Country country = Country_Default)

Esta función devuelve true si el país especificado (o por defecto) es uno de los de Europa Occidental.

Es utilizada internamente por wxDateTime para determinar la convención DST y las reglas de formato de fecha y hora.

IsWorkDay()

bool wxDateTime::IsWorkDay(Country country = Country_Default) const

Devuelve true si este día no es festivo para el país dado.

MakeFromTimezone()

wxDateTime& wxDateTime::MakeFromTimezone( const TimeZone & tz, bool noDST = false )

Igual que FromTimezone() pero modifica el objeto en su lugar.

MakeTimezone()

wxDateTime& wxDateTime::MakeTimezone( const TimeZone & tz, bool noDST = false )

Modifica el objeto en su lugar para representar la fecha en otra zona horaria.

Si noDST es verdadero, no se realizarán ajustes DST.

MakeUTC()

wxDateTime& wxDateTime::MakeUTC(bool noDST = false)

Esto es lo mismo que llamar a MakeTimezone() con el argumento GMT0.

Now()

static wxDateTime wxDateTime::Now()

Devuelve el objeto correspondiente a la hora actual en la zona horaria local.

Ejemplo:

wxDateTime now = wxDateTime::Now();
printf("Current time in Paris:\t%s\n", now.Format("%c", wxDateTime::CET).c_str());

Nota: Esta función tiene una precisión de segundos. Puede utilizarse UNow() si se requiere una mayor precisión.

ParseDate()

bool wxDateTime::ParseDate( const wxString & date, wxString::const_iterator * end )

Esta función es como ParseDateTime(), pero sólo permite especificar la fecha.

Por lo tanto, es menos flexible que ParseDateTime(), pero también tiene menos posibilidades de malinterpretar la entrada del usuario.

Vee ParseFormat() para la descripción de los parámetros de la función y el valor de retorno.

ParseDateTime()

bool wxDateTime::ParseDateTime( const wxString & datetime, wxString::const_iterator * end )

Analiza la cadena datetime que contiene la fecha y la hora en formato libre.

Esta función intenta por todos los medios interpretar la cadena dada como fecha y hora. A diferencia de ParseRfc822Date(), aceptará cualquier cosa que pueda ser aceptada y sólo rechazará cadenas que no puedan ser analizadas de ninguna manera. Hay que tener en cuenta que la función fallará si la parte de fecha u hora está presente pero no ambas, utilizar ParseDate() o ParseTime() para analizar cadenas que contengan sólo el componente de fecha u hora.

Véase ParseFormat() para la descripción de los parámetros de la función y el valor de retorno.

ParseFormat()

bool wxDateTime::ParseFormat( const wxString & date, const wxString & format, const wxDateTime & dateDef, wxString::const_iterator * end )

Analiza la cadena de fecha según el formato dado.

Esta función es similar a strptime(3) pero no la utiliza e implementa el análisis por sí misma, con soporte para todos los especificadores de formato estándar (POSIX) así como un número de extensiones GNU como l, F, z (pero no Z, actualmente), etc.

Consultar la descripción de la función ANSI C strftime(3) para conocer la sintaxis de la cadena de formato.

El parámetro dateDef se utiliza para rellenar los campos que no se han podido determinar a partir de la cadena de formato. Por ejemplo, si el formato es "%d" (el día del mes), el mes y el año se toman de dateDef. Si no se especifica, se utiliza Today() como fecha por defecto.

Ejemplo de uso de esta función:

wxDateTime dt;
wxString str = "...";
wxString::const_iterator end;
if ( !dt.ParseFormat(str, "%Y-%m-%d", &end) )
    ... parsing failed ...
else if ( end == str.end() )
    ... entire string parsed ...
else
    ... wxString(end, str.end()) left over ...

Parámetros

date: La cadena que debe analizarse.
format: Cadena de formato similar a strptime().
dateDef: Se utiliza para rellenar los componentes de fecha no especificados en la cadena de fecha.
end: Se rellenará con el iterador que apunta al lugar donde se detuvo el análisis sintáctico si la función devuelve true. Si se ha consumido toda la cadena, se establece en date.end(). Hay que tener en cuenta que este argumento debe ser no nulo.

Valor de retorno

true si al menos parte de la cadena fue analizada con éxito, false en caso contrario.

ParseFormat()

bool wxDateTime::ParseFormat( const wxString & date, const wxString & format, wxString::const_iterator * end )

Esta es una función miembro sobrecargada, proporcionada por conveniencia. Sólo difiere de la función anterior en los argumentos que acepta.

ParseFormat()

bool wxDateTime::ParseFormat( const wxString & date, wxString::const_iterator * end )

Esta es una función miembro sobrecargada, proporcionada por conveniencia. Sólo difiere de la función anterior en los argumentos que acepta.

ParseISOCombined()

bool wxDateTime::ParseISOCombined( const wxString & date, char sep = 'T' )

Esta función analiza la cadena que contiene la fecha y la hora en el formato combinado ISO 8601 "AAAA-MM-DDTHH:MM:SS".

El separador entre las partes de fecha y hora debe ser igual a sep para que la función tenga éxito.

Valor de retorno

true si se ha analizado correctamente toda la cadena, false en caso contrario.

ParseISODate()

bool wxDateTime::ParseISODate(const wxString & date)

Esta función analiza la fecha en formato ISO 8601 "AAAA-MM-DD".

Valor de retorno

true si se ha analizado correctamente toda la cadena, false en caso contrario.

ParseISOTime()

bool wxDateTime::ParseISOTime(const wxString & date)

Esta función analiza la hora en formato ISO 8601 "HH:MM:SS".

Valor de retorno

true si se ha analizado correctamente toda la cadena, false en caso contrario.

ParseRfc822Date()

bool wxDateTime::ParseRfc822Date( const wxString & date, wxString::const_iterator * end )

Analiza la cadena date buscando en ella una fecha formateada según el RFC 822.

La descripción exacta de este formato puede, por supuesto, encontrarse en el RFC (sección 5), pero, brevemente, este es el formato utilizado en las cabeceras de los mensajes de correo electrónico de Internet y una de las cadenas más comunes que expresan la fecha en este formato puede ser algo como "Sat, 18 Dec 1999 00:48:30 +0100".

Devuelve nullptr si la conversión falló, en caso contrario devuelve el puntero al carácter inmediatamente siguiente a la parte de la cadena que pudo ser analizada. Si toda la cadena contiene sólo la fecha en formato RFC 822, el puntero devuelto apuntará a un carácter NUL.

Esta función es intencionadamente estricta, devolverá un error para cualquier cadena que no sea compatible con RFC 822. Si se necesita parsear fechas formateadas de maneras más libres, se debería utilizar ParseDateTime() o ParseDate() en su lugar.

Ver ParseFormat() para la descripción de los parámetros de la función y el valor de retorno.

ParseTime()

bool wxDateTime::ParseTime( const wxString & time, wxString::const_iterator * end )

Esta función es como ParseDateTime(), pero sólo permite especificar la hora en la cadena de entrada.

Ver ParseFormat() para la descripción de los parámetros de la función y el valor de retorno.

ResetTime()

wxDateTime& wxDateTime::ResetTime()

Restablece la hora a medianoche (00:00:00) sin cambiar la fecha.

Set()

wxDateTime& wxDateTime::Set(const struct tm & tm)

Establece la fecha y la hora a partir de la representación desglosada en la estructura estándar tm.

Set()

wxDateTime& wxDateTime::Set(const Tm & tm)

Establece la fecha y la hora a partir de la representación desglosada en la estructura wxDateTime::Tm.

Set()

wxDateTime& wxDateTime::Set(double jdn)

Establece la fecha a partir del llamado Número de Día Juliano.

Por definición, el Número de Día Juliano, normalmente abreviado como JDN, de un instante concreto es el número fraccionario de días transcurridos desde las 12 horas del Tiempo Universal Coordinado (mediodía medio de Greenwich) del 1 de enero del año -4712 en el calendario proléptico juliano.

Set()

wxDateTime& wxDateTime::Set(time_t timet)

Construye el objeto a partir del valor timet que contiene el número de segundos transcurridos desde el 1 de enero de 1970 UTC.

Si timet no es válido, es decir (time_t)-1 wxDateTime tampoco será válida, es decir, su función IsValid() devolverá false.

Set()

wxDateTime& wxDateTime::Set( wxDateTime_t day, Month month, int year = Inv_Year, wxDateTime_t hour = 0, wxDateTime_t minute = 0, wxDateTime_t second = 0, wxDateTime_t millisec = 0 )

Establece la fecha y la hora a partir de los parámetros.

Si los parámetros de la función no son válidos, por ejemplo, el mes es febrero y el día es 30, el objeto se deja en un estado no válido, es decir, el método IsValid() devolverá false.

Si el momento horario especificado no es válido debido al horario de verano, es decir, cae en la hora "que falta" en la fecha en que comienza el horario de verano, se sigue construyendo un objeto wxDateTime válido, pero su componente horario se adelanta para asegurar que corresponde a un momento válido en la zona horaria local. Por ejemplo, en la zona horaria CET el DST comenzó el 2013-03-31T02:00:00 de 2013, por lo que establecer el objeto a las 2:30 en esta fecha en realidad establece la hora en 3, y no en 2.

Set()

wxDateTime& wxDateTime::Set( wxDateTime_t hour, wxDateTime_t minute = 0, wxDateTime_t second = 0, wxDateTime_t millisec = 0 )

Establece la fecha igual a Today() y la hora a partir de los parámetros suministrados.

Ver la sobrecarga Set() completa para las observaciones sobre DST.

SetCountry()

static void wxDateTime::SetCountry(Country country)

Establece el país que se utilizará por defecto.

Este ajuste influye en los cálculos DST, el formato de fecha y otras cosas.

SetDay()

wxDateTime& wxDateTime::SetDay(unsigned short day)

Establece el día sin cambiar otros componentes de la fecha.

SetFromDOS()

wxDateTime& wxDateTime::SetFromDOS(unsigned long ddt)

Establece la fecha a partir de la fecha y hora en formato DOS.

SetFromMSWSysTime()

wxDateTime& wxDateTime::SetFromMSWSysTime(const struct _SYSTEMTIME &M st)

Inicializar utilizando la estructura SYSTEMTIME de Windows.

Parámetros

st: Entrada, referencia a la SYSTEMTIME de Windows

Observaciones

Sólo MSW.

SetHour()

wxDateTime& wxDateTime::SetHour(unsigned short hour)

Establece la hora sin cambiar otros componentes de la fecha.

SetMillisecond()

wxDateTime& wxDateTime::SetMillisecond(unsigned short millisecond)

Establece el milisegundo sin cambiar otros componentes de la fecha.

SetMinute()

wxDateTime& wxDateTime::SetMinute(unsigned short minute)

Establece el minuto sin cambiar otros componentes de la fecha.

SetMonth()

wxDateTime& wxDateTime::SetMonth(Month month)

Establece el mes sin cambiar otros componentes de la fecha.

SetSecond()

wxDateTime& wxDateTime::SetSecond(unsigned short second)

Establece el segundo sin cambiar otros componentes de la fecha.

SetToCurrent()

wxDateTime& wxDateTime::SetToCurrent()

Establece la fecha y la hora de a los valores actuales.

Es lo mismo que asignar el resultado de Now() a este objeto.

SetToLastMonthDay()

wxDateTime& wxDateTime::SetToLastMonthDay( Month month = Inv_Month, int year = Inv_Year )

Establece la fecha en el último día del mes especificado (el actual por defecto).

Valor de retorno

La referencia al objeto modificado.

SetToLastWeekDay()

bool wxDateTime::SetToLastWeekDay( WeekDay weekday, Month month = Inv_Month, int year = Inv_Year )

El efecto de llamar a esta función es el mismo que el de llamar a SetToWeekDay(-1, weekday, month, year).

La fecha se fijará en el último día de la semana del mes y año dados (los actuales por defecto). Siempre devuelve verdadero.

SetToNextWeekDay()

wxDateTime& wxDateTime::SetToNextWeekDay(WeekDay weekday)

Establece la fecha para que sea el primer día de la semana siguiente a la fecha actual.

Valor de retorno

La referencia al objeto modificado.

SetToPrevWeekDay()

wxDateTime& wxDateTime::SetToPrevWeekDay(WeekDay weekday)

Establece la fecha para que sea el último día de la semana anterior a la fecha actual.

Valor de retorno

La referencia al objeto modificado.

SetToWeekDay()

bool wxDateTime::SetToWeekDay( WeekDay weekday, int n = 1, Month month = Inv_Month, int year = Inv_Year )

Fija la fecha en el n-ésimo día de la semana del mes y año dados (por defecto se utilizan el mes y año actuales).

El parámetro n puede ser positivo (contando desde el principio del mes) o negativo (contando desde el final del mes).

Por ejemplo, SetToWeekDay(wxDateTime::Wed, 2) fijará la fecha en el segundo miércoles del mes actual y SetToWeekDay(wxDateTime::Sun, -1) fijará la fecha en el último domingo del mes actual.

Hay que tener en cuenta que si deja los parámetros de mes o año con sus valores por defecto, se sustituirá por el mes o año actual, sobrescribiendo cualquier valor anterior del objeto wxDateTime.

Valor de retorno

true si la fecha fue modificada con éxito, false en caso contrario significa que la fecha especificada no existe.

SetToWeekDayInSameWeek()

wxDateTime& wxDateTime::SetToWeekDayInSameWeek( WeekDay weekday, WeekFlags flags = Monday_First )

Ajusta la fecha para que siga estando en la misma semana que antes, pero su día de la semana será el dado.

Valor de retorno

La referencia al objeto modificado.

SetToWeekOfYear()

static wxDateTime wxDateTime::SetToWeekOfYear( int year, wxDateTime_t numWeek, WeekDay weekday = Mon )

Establece la fecha en el día de la semana numSemana del año indicado.

El número debe estar en el rango 1-53.

Hay que tener en cuenta que la fecha devuelta puede estar en un año diferente al que se ha pasado a esta función porque tanto la semana 1 como la semana 52 o 53 (para años bisiestos) contienen días de años diferentes. Ver GetWeekOfYear() para la explicación de cómo se cuentan las semanas del año.

SetToYearDay()

wxDateTime& wxDateTime::SetToYearDay(wxDateTime_t yday)

Fija la fecha en el número de día yday del mismo año (es decir, a diferencia de las otras funciones, ésta no utiliza el año en curso).

El número de día debe estar en el rango 1-366 para los años bisiestos y 1-365 para los demás.

Valor de retorno

La referencia al propio objeto modificado.

SetYear()

wxDateTime& wxDateTime::SetYear(int year)

Establece el año sin cambiar otros componentes de la fecha.

Subtract()

wxDateTime& wxDateTime::Subtract(const wxDateSpan & diff)

Resta el intervalo de fechas dado de este objeto.

Subtract()

wxDateTime wxDateTime::Subtract(const wxDateSpan & diff) const

Resta el intervalo de fechas dado de este objeto.

Subtract()

wxTimeSpan wxDateTime::Subtract(const wxDateTime & dt) const

Resta otra fecha de esta y devuelve la diferencia entre ellas como un wxTimeSpan.

Subtract()

wxDateTime& wxDateTime::Subtract(const wxTimeSpan & diff)

Resta el intervalo de tiempo dado de este objeto.

Subtract()

wxDateTime wxDateTime::Subtract(const wxTimeSpan & diff) const

Resta el intervalo de tiempo dado de este objeto.

Today()

static wxDateTime wxDateTime::Today()

Devuelve el objeto correspondiente a la medianoche del día actual (es decir, lo mismo que Now(), pero la parte del tiempo se pone a 0).

ToTimezone()

wxDateTime wxDateTime::ToTimezone( const TimeZone & tz, bool noDST = false ) const

Transforma la fecha a la zona horaria dada.

Si noDST es verdadero, no se realizará ningún ajuste DST.

Si el parámetro tz es wxDateTime::Local, no se realizará ningún ajuste.

Valor de retorno

La fecha ajustada por la diferencia entre la zona horaria local y la zona horaria dada.

ToUTC()

wxDateTime wxDateTime::ToUTC(bool noDST = false) const

Esto es lo mismo que llamar a ToTimezone() con el argumento GMT0.

UNow()

static wxDateTime wxDateTime::UNow()

Devuelve el objeto correspondiente a la hora actual incluyendo los milisegundos.

Al igual que Now(), este método crea el objeto wxDateTime correspondiente al momento actual en tiempo local.

Operadores miembro

operator+()

wxDateTime wxDateTime::operator+(const wxDateSpan & ds) const

Añade el intervalo de fechas dado a este objeto.

operator+()

wxDateTime wxDateTime::operator+(const wxTimeSpan & ts) const

Añade el intervalo de tiempo dado a este objeto.

operator+=()

wxDateTime& wxDateTime::operator+=(const wxDateSpan & diff)

Añade el intervalo de fechas dado a este objeto.

operator+=()

wxDateTime& wxDateTime::operator+=(const wxTimeSpan & diff)

Añade el intervalo de tiempo dado a este objeto.

operator-()

wxDateTime wxDateTime::operator-(const wxDateSpan & ds) const

Resta el intervalo de fechas dado de este objeto.

operator-()

wxTimeSpan wxDateTime::operator-(const wxDateSpan & dt2) const

Resta otra fecha de esta y devuelve la diferencia entre ellas como un wxTimeSpan.

operator-()

wxTimeSpan & wxDateTime::operator-(const wxTimeSpan & ts) const

Resta el intervalo de tiempo dado de este objeto.

operator-=()

wxDateTime& wxDateTime::operator-=(const wxDateSpan & diff)

Resta el intervalo de fechas dado de este objeto.

operator-=()

wxDateTime& wxDateTime::operator-=(const wxTimeSpan & diff)

Resta el intervalo de tiempo dado de este objeto.

operator=()

wxDateTime& wxDateTime::operator=(const struct tm & tm)

Lo mismo que Set.

operator=(()

wxDateTime& wxDateTime::operator=(time_t timet)

Lo mismo que Set.