Altova MapForce 2024 Professional Edition

Esta clase permite procesar atributos o elementos XML que tienen tipos de fecha y hora (p. ej. xs:dateTime).

 

Constructores

 


Nombre

Descripción

ic_java_constructor

public DateTime()

Inicializa una instancia nueva de la clase DateTime en un valor vacío.

ic_java_constructor

public DateTime(DateTime newvalue)

Inicializa una instancia nueva de la clase DateTime en el valor DateTime dado como argumento.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond, int newoffsetTZ)

Inicializa una instancia nueva de la clase DateTime en el año, mes, día, hora, minuto, segundo, la parte fraccionaria del segundo y la zona horaria dados como argumentos. La parte fraccionaria del segundo newpartsecond debe estar comprendida entre 0 y 1. La diferencia de zona horaria newoffsetTZ puede ser negativa o positivo y se expresa en minutos.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday, int newhour, int newminute, int newsecond, double newpartsecond)

Inicializa una instancia nueva de la clase DateTime en el año, mes, día, hora, minuto, segundo y la parte fraccionaria de un segundo dados como argumentos.

ic_java_constructor

public DateTime(int newyear, int newmonth, int newday)

Inicializa una instancia nueva de la clase DateTime en el año, mes y día dados como argumentos.

ic_java_constructor

public DateTime(Calendar newvalue)

Inicializa una instancia nueva de la clase DateTime en el valor java.util.Calendar dado como argumento.

 

Métodos

 


Nombre

Descripción

ic_java_public_static

static DateTime now()

Devuelve la hora actual como un objeto DateTime.

ic_java_public_static

static DateTime parse(String s)

Devuelve un objeto DateTime analizado desde el valor de cadena dado como argumento. Por ejemplo, estos valores de cadena de muestra se convertirían correctamente en un objeto DateTime:

 

2015-11-24T12:54:47.969+01:00

2015-11-24T12:54:47

2015-11-24

ic_java_public_member

int getDay()

Devuelve el día de la instancia DateTime actual.

ic_java_public_member

int getHour()

Devuelve la hora de la instancia DateTime actual.

ic_java_public_member

int getMillisecond()

Devuelve el milisegundo de la instancia DateTime actual, como valor entero.

ic_java_public_member

int getMinute()

Devuelve el minuto de la instancia DateTime actual.

ic_java_public_member

int getMonth()

Devuelve el mes de la instancia DateTime actual.

ic_java_public_member

double getPartSecond()

Devuelve la parte fraccionaria del segundo de la instancia DateTime actual, como valor double. El valor devuelto es mayor que cero y menor que uno. Por ejemplo:

 

0.313

ic_java_public_member

int getSecond()

Devuelve el segundo de la instancia DateTime actual.

ic_java_public_member

int getTimezoneOffset()

Devuelve la diferencia de zona horaria, en minutos, de la instancia DateTime actual. Por ejemplo, la zona horaria "UTC-01:00" se devolvería como:

 

-60

ic_java_public_member

Calendar getValue()

Devuelve la instancia DateTime actual como un valor java.util.Calendar.

ic_java_public_member

int getWeekday()

Devuelve el día de la semana de la instancia DateTime actual. Los valores están comprendidos entre el 0 y el 6, siendo 0 el lunes (ISO-8601).

ic_java_public_member

int getYear()

Devuelve el año de la instancia DateTime actual.

ic_java_public_member

int hasTimezone()

Devuelve información sobre la zona horaria de la instancia DateTime actual. Los valores devueltos posibles son:

CalendarBase.TZ_MISSING

No está definida la diferencia de zona horaria.

CalendarBase.TZ_UTC

La zona horaria es UTC.

CalendarBase.TZ_OFFSET

Está definida una diferencia de zona horaria.

ic_java_public_member

void setDay( int nDay )

Establece el día de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setHasTimezone( int nHasTZ )

Establece la información de zona horaria de la instancia DateTime actual en el valor dado como argumento. Este método puede utilizarse para eliminar la información de zona horaria o establecer la zona horaria en UTC (hora universal coordinada). Los valores válidos para el argumento nHasTZ son:

CalendarBase.TZ_MISSING

Establecer la diferencia de zona horaria como indefinida.

CalendarBase.TZ_UTC

Establecer la zona horaria en UTC.

CalendarBase.TZ_OFFSET

Si el objeto actual tiene una diferencia de zona horaria, dejarla sin cambiar.

ic_java_public_member

void setHour( int nHour )

Establece la hora de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setMinute( int nMinute )

Establece el minuto de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setMonth( int nMonth )

Establece el mes de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setPartSecond( double nPartSecond )

Establece la parte fraccionaria del segundo de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setSecond( int nSecond )

Establece el segundo de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

void setTimezoneOffset( int nOffsetTZ )

Establece la diferencia de zona horaria de la instancia DateTime actual en el valor dado como argumento. El valor nOffsetTZ debe ser un entero (negativo o positivo) y debe expresarse en minutos.

ic_java_public_member

void setYear( int nYear )

Establece el año de la instancia DateTime actual en el valor dado como argumento.

ic_java_public_member

String toString()

Devuelve la representación de cadena de la instancia DateTime actual. Por ejemplo:

 

2015-11-24T15:50:56.968+01:00

 

Ejemplos

 

Antes de usar este ejemplo en su programa debe importar los tipos de Altova:

 

import com.altova.types.*;

 

Este ejemplo muestra cómo se pueden crear objetos DateTime:

 

protected static void DateTimeExample1()
{
  // Inicializar una instancia nueva de la clase DateTime en la hora actual
  DateTime dt = new DateTime(DateTime.now());
  System.out.println("DateTime created from current date and time: " + dt.toString());
     
  // Inicializar una instancia nueva de la clase DateTime aportando las partes
  DateTime dt1 = new DateTime(2015, 11, 23, 14, 30, 24, .459);
  System.out.println("DateTime from parts (no timezone): " + dt1.toString());
 
  // Inicializar una instancia nueva de la clase DateTime aportando las partes
  DateTime dt2 = new DateTime(2015, 11, 24, 14, 30, 24, .459, -60);
  System.out.println("DateTime from parts (with negative timezone): " + dt2.toString());
     
  // Inicializar una instancia nueva de la clase DateTime analizando un valor de cadena

 DateTime dt3 = DateTime.parse("2015-11-24T12:54:47.969+01:00");            
  System.out.println("DateTime parsed from string: " + dt3.toString());        
}      

 

Este ejemplo muestra cómo se pueden obtener valores de objetos DateTime:

 

protected static void DateTimeExample2()
  {
    // Inicializar una instancia nueva de la clase DateTime en la hora actual
    DateTime dt = new DateTime(DateTime.now());
       
    // Generar el año, mes y día de esta instancia DateTime con formato
    String str1 = String.format("Year: %d; Month: %d; Day: %d;", dt.getYear(), dt.getMonth(), dt.getDay());
    System.out.println(str1);
       
    // Generar la hora, el minuto y el segundo de esta instancia DateTime con formato
    String str2 = String.format("Hour: %d; Minute: %d; Second: %d;", dt.getHour(), dt.getMinute(), dt.getSecond());
    System.out.println(str2);
       
    // Devolver la zona horaria (en minutos) de esta instancia DateTime
    System.out.println("Timezone: " + dt.getTimezoneOffset());
       
    // Obtener DateTime como valor java.util.Calendar
    java.util.Calendar dt_java = dt.getValue();
    System.out.println("" + dt_java.toString());
       
    // Devolver el día de la semana de esta instancia DateTime
    System.out.println("Weekday: " + dt.getWeekday());        
     
    // Comprobar si la instancia DateTime tiene definida una zona horaria
    switch(dt.hasTimezone())
    {
        case CalendarBase.TZ_MISSING:
          System.out.println("Sin zona horaria.");
          break;
        case CalendarBase.TZ_UTC:            
          System.out.println("La zona horaria es UTC.");
          break;
        case CalendarBase.TZ_OFFSET:
          System.out.println("Este objeto tiene una zona horaria.");
          break;
        default:
          System.out.println("Imposible determinar si se definió una zona horaria.");
          break;
    }      
  }

 

Este ejemplo muestra cómo se puede cambiar la diferencia horaria de un objeto DateTime:

 

protected static void DateTimeExample3()
{      
  // Crear un objeto DateTime nuevo con zona horaria -0100 UTC
  DateTime dt = new DateTime(2015, 11, 24, 14, 30, 24, .459, -60);
  // Generar el valor antes del cambio
  System.out.println("Before: " + dt.toString());
  // Cambiar la diferencia a +0100 UTC
  dt.setTimezoneOffset(60);            
  // Generar el valor después del cambio
  System.out.println("After:  " + dt.toString());
}

© 2017-2023 Altova GmbH