Month es, básicamente una enumeración que contiene los nombres de los doce meses del año… aunque, además, nos proporciona una serie de métodos que nos permiten trabajar mas fácilmente con el objeto Mes. La enumeracion de que dispone soporta: JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER; aunque para salida, los podremos conseguir en el idioma que necesitemos
of(), from(), valueOf(), values()
static Month of(int month)
static Month from(TemporalAccessor temporal)
static Month valueOf(String name)Nos permite crear un objeto Month:
- Indicando el numero del mas
- Facilitando un campo temporal que contenga un mes, como LocalDate, o LocalDateTime
- Indicando el nombre de mes, tal y como esta en la enumeracion, (JANUARY, FEBRUARY…)
static Month[] values()Crea un array con los 12 objetos correspondientes a los 12 Meses
Si queremos ver todo esto en un ejemplo, podemos hacer:
public static void main(String[] args) {
Month febrero = Month.of(2);
System.out.println("febrero : " + febrero);
LocalDate undia = LocalDate.parse("2017-03-23");
Month nose = Month.from(undia);
System.out.println("nose : " + nose);
Month deVal = Month.valueOf("JUNE");
System.out.println("deVal : " + deVal);
Month[] todos = Month.values();
System.out.println("Lista........");
Arrays.stream(todos).forEach(System.out::println);
}Para obtener:
plus(), minus()
Month minus(long months)
Month plus(long months)Nos permite obtener un nuevo mes, tras sumarle o restarle al anterior la cantidad indicada
Enel ejemplo, sumamos a Febrero 3, en una ocasión, y restamos 2 en otra. El paso de un año a otro, en este ejercicio no se tiene en cuenta, ya que solo se trabaja con meses
public static void main(String[] args) {
Month febrero = Month.of(2);
System.out.println("febrero : " + febrero);
Month mas3 = febrero.plus(3);
System.out.println("mas3 : " + mas3);
Month menos2 = febrero.minus(2);
System.out.println("menos2 : " + menos2);
}El resultado que da es:
isSupported()
boolean isSupported(TemporalField field)Nos indica si el tipo de campo temporal esta soportado en Month
Podemos ver su uso en un ejemplo
public static void main(String[] args) {
Month d1 = Month.of(8);
boolean ms = d1.isSupported(ChronoField.MILLI_OF_SECOND);
boolean dw = d1.isSupported(ChronoField.DAY_OF_WEEK);
boolean dm = d1.isSupported(ChronoField.MONTH_OF_YEAR);
System.out.println("Soporta ChronoField.MILLI_OF_SECOND:"+ms);
System.out.println("Soporta ChronoField.DAY_OF_WEEK:"+dw);
System.out.println("Soporta ChronoField.MONTH_OF_YEAR:"+dm);
}Si lo hacemos correr, veremos que solo esta soportado el mes
get(), getDisplayName(), getLong(), getValue()
int get(TemporalField field)
String getDisplayName(TextStyle style, Locale locale)
long getLong(TemporalField field)
int getValue()Nos permite obtener
- El valor de un dato, en este caso, solo esta autorizado el numero del mes
- El nombre del mes, en el idioma indicado en Locale
En el ejemplo vemos como se comporta
public static void main(String[] args) {
Month d1 = Month.of(4);
System.out.println("Numero mes : "
+ d1.get(ChronoField.MONTH_OF_YEAR));
Locale es = new Locale("es", "ES");
Locale fr = Locale.FRENCH;
System.out.println("Mes es : "
+ d1.getDisplayName(TextStyle.FULL,es));
System.out.println("Mes fr : "
+ d1.getDisplayName(TextStyle.FULL,fr));
System.out.println("getLong : "
+ d1.getLong(ChronoField.MONTH_OF_YEAR));
System.out.println("getValue : "
+ d1.getValue());
}Y nos presenta el numero del mes, y el nombre en dos idiomas, según el Locale
length(), maxLength(), minLength()
int length(boolean leapYear)
int maxLength()
int minLength()Nos facilita el numero de días que tiene el mes, para lo que tenemos que indicar si el año es bisiesto o no, y la longitud del mes, máxima y mínima
El ejemplo podria ser:
public static void main(String[] args) {
Year dato = Year.of(2020);
Month mes = Month.of(2);
System.out.println("Longitud minima : "
+ mes.minLength());
System.out.println("Longitud maxima : "
+ mes.maxLength());
System.out.println("Longitud exacta : "
+ mes.length(dato.isLeap()));
}Que nos daría
range()
ValueRange range(TemporalField field)Nos facilita un ValueRange con el numero mínimo y máximo de meses en un año
Si preparamos este ejemplo:
public static void main(String[] args) {
Month mes = Month.of(2);
System.out.println("Range : "
+ mes.range(ChronoField.MONTH_OF_YEAR));
}Nos aparece
adjustInto()
Temporal adjustInto(Temporal temporal)Obtiene un nuevo objeto temporal aplicando el mes indicado en el objeto temporal pasado
Vemos en el ejemplo, como obtenemos una LocalDate ajustada, si utilizamos el metodo
public static void main(String[] args) {
LocalDate undia = LocalDate.parse("2017-03-23");
Month elMes = Month.of(9);
System.out.println("Fecha :" + undia);
LocalDate otro = (LocalDate)elMes.adjustInto(undia);
System.out.println("Fecha ajustada :" + otro);
}Veremos como se convierte la fecha
firstDayOfYear()
int firstDayOfYear(boolean leapYear)Nos calcula que día del año es el primer día del mas. Debemos indicar si hablamos de un año bisiesto o no, ya que a partir de Marzo, tendrá importancia
Vemos un pequeño ejemplo de como lo podríamos hacer
public static void main(String[] args) {
Month elMes = Month.of(2);
System.out.println("Dia del año :" +
elMes.firstDayOfYear(Year.isLeap(2016)));
}
Y nos dira que el primer dia de febrero es el 32 del año
firstMonthOfQuarter()
Month firstMonthOfQuarter()Nos facilita un objeto Month correspondiente al mes que inicia el trimestre que pasamos
En el ejemplo, preguntamos por el mes que inicia el trimestre en que se encuentra Junio, y luego Noviembre
public static void main(String[] args) {
Month elMes = Month.of(6);
System.out.println("Inicio trimestre de Junio :" +
elMes.firstMonthOfQuarter());
Month elMes2 = Month.of(11);
System.out.println("Inicio trimestre de Noviembre:" +
elMes2.firstMonthOfQuarter());
}y la respuesta es
Conclusión
La clase Month mantiene información acerca de un mes, y, aunque solo acepta consultas acerca del mes puede ser reutilizados con el resto de clases de la api java.time
Este articulo detalle una de las clases de la api java.time descritas anteriormente en el indice que se facilito sobre este tema
