org.thymeleaf.expression.Dates Maven / Gradle / Ivy

Go to download
/*
 * =============================================================================
 * 
 *   Copyright (c) 2011-2016, The THYMELEAF team (http://www.thymeleaf.org)
 * 
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 * 
 *       http://www.apache.org/licenses/LICENSE-2.0
 * 
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 * 
 * =============================================================================
 */
package org.thymeleaf.expression;

import java.util.ArrayList;
import java.util.Date;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;

import org.thymeleaf.exceptions.TemplateProcessingException;
import org.thymeleaf.util.DateUtils;
import org.thymeleaf.util.Validate;


/**
 * 
 *   Expression Object for performing dates ({@link Date}) operations inside Thymeleaf Standard Expressions.
 * 
 * 
 *   An object of this class is usually available in variable evaluation expressions with the name
 *   #dates.
 * 
 * 
 * @author Daniel Fernández
 * 
 * @since 1.0
 *
 */
public final class Dates {


    private final Locale locale;




    public Dates(final Locale locale) {
        super();
        Validate.notNull(locale, "Locale cannot be null");
        this.locale = locale;
    }

    
    
    
    
    /**
     * 
     * @param year year
     * @param month month
     * @param day day
     * @return the result
     * @since 1.1.2
     */
    public Date create(final Object year, final Object month, final Object day) {
        return DateUtils.create(year, month, day, null, null, null, null, null, this.locale).getTime();
    }

    
    /**
     * 
     * @param year year
     * @param month month
     * @param day day
     * @param hour hour
     * @param minute minute
     * @return the result
     * @since 1.1.2
     */
    public Date create(final Object year, final Object month, final Object day,
            final Object hour, final Object minute) {
        return DateUtils.create(year, month, day, hour, minute, null, null, null, this.locale).getTime();
    }

    
    /**
     * 
     * @param year year
     * @param month month
     * @param day day
     * @param hour hour
     * @param minute minute
     * @param second second
     * @return the result
     * @since 1.1.2
     */
    public Date create(final Object year, final Object month, final Object day,
            final Object hour, final Object minute, final Object second) {
        return DateUtils.create(year, month, day, hour, minute, second, null, null, this.locale).getTime();
    }


    /**
     * 
     * @param year year
     * @param month month
     * @param day day
     * @param hour hour
     * @param minute minute
     * @param second second
     * @param millisecond millisecond
     * @return the result
     * @since 1.1.2
     */
    public Date create(final Object year, final Object month, final Object day,
            final Object hour, final Object minute, final Object second, final Object millisecond) {
        return DateUtils.create(year, month, day, hour, minute, second, millisecond, null, this.locale).getTime();
    }


    /**
     * 
     * @return the result
     * @since 1.1.2
     */
    public Date createNow() {
        return DateUtils.createNow(null, this.locale).getTime();
    }


    /**
     * 
     * @param timeZone timeZone
     * @return the result
     * @since 2.1.0
     */
    public Date createNowForTimeZone(final Object timeZone) {
        return DateUtils.createNow(timeZone, this.locale).getTime();
    }


    /**
     * 
     * @return the result
     * @since 1.1.2
     */
    public Date createToday() {
        return DateUtils.createToday(null, this.locale).getTime();
    }


    /**
     * 
     * @param timeZone timeZone
     * @return the result
     * @since 2.1.0
     */
    public Date createTodayForTimeZone(final Object timeZone) {
        return DateUtils.createToday(timeZone, this.locale).getTime();
    }

    
    
    
    public String format(final Date target) {
        if (target == null) {
            return null;
        }
        try {
            return DateUtils.format(target, this.locale);
        } catch (final Exception e) {
            throw new TemplateProcessingException(
                    "Error formatting date with standard format for locale " + this.locale, e);
        }
    }
    
    public String[] arrayFormat(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = format((Date)target[i]);
        }
        return result;
    }
    
    public List listFormat(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(format(element));
        }
        return result;
    }
    
    public Set setFormat(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(format(element));
        }
        return result;
    }

    
    
    
    public String format(final Date target, final String pattern) {
        if (target == null) {
            return null;
        }
        try {
            return DateUtils.format(target, pattern, this.locale);
        } catch (final Exception e) {
            throw new TemplateProcessingException(
                    "Error formatting date with format pattern \"" + pattern + "\"", e);
        }
    }
    
    public String[] arrayFormat(final Object[] target, final String pattern) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = format((Date)target[i], pattern);
        }
        return result;
    }
    
    public List listFormat(final List target, final String pattern) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(format(element, pattern));
        }
        return result;
    }
    
    public Set setFormat(final Set target, final String pattern) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(format(element, pattern));
        }
        return result;
    }

    
    
    

    public Integer day(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.day(target);
    }
    
    public Integer[] arrayDay(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = day((Date)target[i]);
        }
        return result;
    }
    
    public List listDay(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(day(element));
        }
        return result;
    }
    
    public Set setDay(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(day(element));
        }
        return result;
    }

    
    
    

    public Integer month(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.month(target);
    }
    
    public Integer[] arrayMonth(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = month((Date)target[i]);
        }
        return result;
    }
    
    public List listMonth(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(month(element));
        }
        return result;
    }
    
    public Set setMonth(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(month(element));
        }
        return result;
    }


    
    

    public String monthName(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.monthName(target, this.locale);
    }
    
    public String[] arrayMonthName(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = monthName((Date)target[i]);
        }
        return result;
    }
    
    public List listMonthName(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(monthName(element));
        }
        return result;
    }
    
    public Set setMonthName(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(monthName(element));
        }
        return result;
    }

    
    

    public String monthNameShort(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.monthNameShort(target, this.locale);
    }
    
    public String[] arrayMonthNameShort(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = monthNameShort((Date)target[i]);
        }
        return result;
    }
    
    public List listMonthNameShort(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(monthNameShort(element));
        }
        return result;
    }
    
    public Set setMonthNameShort(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(monthNameShort(element));
        }
        return result;
    }

    
    
    
    

    public Integer year(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.year(target);
    }
    
    public Integer[] arrayYear(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = year((Date)target[i]);
        }
        return result;
    }
    
    public List listYear(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(year(element));
        }
        return result;
    }
    
    public Set setYear(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(year(element));
        }
        return result;
    }

    
    
    

    public Integer dayOfWeek(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.dayOfWeek(target);
    }
    
    public Integer[] arrayDayOfWeek(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = dayOfWeek((Date)target[i]);
        }
        return result;
    }
    
    public List listDayOfWeek(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeek(element));
        }
        return result;
    }
    
    public Set setDayOfWeek(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeek(element));
        }
        return result;
    }
    

    
    
    

    public String dayOfWeekName(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.dayOfWeekName(target, this.locale);
    }
    
    public String[] arrayDayOfWeekName(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = dayOfWeekName((Date)target[i]);
        }
        return result;
    }
    
    public List listDayOfWeekName(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeekName(element));
        }
        return result;
    }
    
    public Set setDayOfWeekName(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeekName(element));
        }
        return result;
    }

    
    
    
    

    public String dayOfWeekNameShort(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.dayOfWeekNameShort(target, this.locale);
    }
    
    public String[] arrayDayOfWeekNameShort(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = dayOfWeekNameShort((Date)target[i]);
        }
        return result;
    }
    
    public List listDayOfWeekNameShort(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeekNameShort(element));
        }
        return result;
    }
    
    public Set setDayOfWeekNameShort(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(dayOfWeekNameShort(element));
        }
        return result;
    }

    
    
    

    

    
    
    

    public Integer hour(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.hour(target);
    }
    
    public Integer[] arrayHour(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = hour((Date)target[i]);
        }
        return result;
    }
    
    public List listHour(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(hour(element));
        }
        return result;
    }
    
    public Set setHour(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(hour(element));
        }
        return result;
    }

    

    
    
    

    public Integer minute(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.minute(target);
    }
    
    public Integer[] arrayMinute(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = minute((Date)target[i]);
        }
        return result;
    }
    
    public List listMinute(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(minute(element));
        }
        return result;
    }
    
    public Set setMinute(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(minute(element));
        }
        return result;
    }

    

    
    
    

    public Integer second(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.second(target);
    }
    
    public Integer[] arraySecond(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = second((Date)target[i]);
        }
        return result;
    }
    
    public List listSecond(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(second(element));
        }
        return result;
    }
    
    public Set setSecond(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(second(element));
        }
        return result;
    }

    

    
    
    

    public Integer millisecond(final Date target) {
        if (target == null) {
            return null;
        }
        return DateUtils.millisecond(target);
    }
    
    public Integer[] arrayMillisecond(final Object[] target) {
        if (target == null) {
            return null;
        }
        final Integer[] result = new Integer[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = millisecond((Date)target[i]);
        }
        return result;
    }
    
    public List listMillisecond(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(millisecond(element));
        }
        return result;
    }
    
    public Set setMillisecond(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(millisecond(element));
        }
        return result;
    }




    /**
     * 
     * @param target target
     * @return the result
     * @since 2.1.4
     */
    public String formatISO(final Date target) {
        if (target == null) {
            return null;
        }
        try {
            return DateUtils.formatISO(target);
        } catch (final Exception e) {
            throw new TemplateProcessingException("Error formatting date as ISO8601", e);
        }
    }

    /**
     * 
     * @param target target
     * @return the result
     * @since 2.1.4
     */
    public String[] arrayFormatISO(final Object[] target) {
        if (target == null) {
            return null;
        }
        final String[] result = new String[target.length];
        for (int i = 0; i < target.length; i++) {
            result[i] = formatISO((Date) target[i]);
        }
        return result;
    }

    /**
     * 
     * @param target target
     * @return the result
     * @since 2.1.4
     */
    public List listFormatISO(final List target) {
        if (target == null) {
            return null;
        }
        final List result = new ArrayList(target.size() + 2);
        for (final Date element : target) {
            result.add(formatISO(element));
        }
        return result;
    }

    /**
     * 
     * @param target target
     * @return the result
     * @since 2.1.4
     */
    public Set setFormatISO(final Set target) {
        if (target == null) {
            return null;
        }
        final Set result = new LinkedHashSet(target.size() + 2);
        for (final Date element : target) {
            result.add(formatISO(element));
        }
        return result;
    }


}