io.virtdata.libbasics.shared.from_long.to_time_types.joda.ToMillisAtStartOfMinute Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of virtdata-lib-realer Show documentation

With inspiration from other libraries

There is a newer version: 2.12.15

package io.virtdata.libbasics.shared.from_long.to_time_types.joda;

import io.virtdata.annotations.Categories;
import io.virtdata.annotations.Category;
import io.virtdata.annotations.Example;
import io.virtdata.annotations.ThreadSafeMapper;
import org.joda.time.DateTime;
import org.joda.time.DateTimeZone;

import java.util.function.LongUnaryOperator;

/**
 * Return the epoch milliseconds at the start of the minute for the given
 * epoch milliseconds.
 */
@Categories({Category.datetime})
@ThreadSafeMapper
public class ToMillisAtStartOfMinute implements LongUnaryOperator {
    private final DateTimeZone tz;

    @Example({"ToMillisAtStartOfMinute()","return millisecond epoch time of the start of the minute of the provided millisecond epoch time, assuming UTC"})
    public ToMillisAtStartOfMinute() {
        this(DateTimeZone.UTC.getID());
    }

    @Example({"ToMillisAtStartOfMinute('America/Chicago')","return millisecond epoch time of the start of the minute of the provided millisecond epoch time, using timezone America/Chicago"})
    public ToMillisAtStartOfMinute(String timezoneId) {
        this.tz = Timezones.forId(timezoneId);
    }

    @Override
    public long applyAsLong(long operand) {
        return new DateTime(operand,tz).withMillisOfSecond(0).withSecondOfMinute(0).getMillis();
    }
}