net.sf.janos.util.TimeUtilities.java Source code

Introduction

Here is the source code for net.sf.janos.util.TimeUtilities.java

Source

/*
 * Copyright 2008 David Wheeler
 *
 * 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 net.sf.janos.util;

import org.joda.time.DateTime;
import org.joda.time.Duration;
import org.joda.time.Instant;
import org.joda.time.Period;
import org.joda.time.format.PeriodFormatter;
import org.joda.time.format.PeriodFormatterBuilder;

/**
 * A collection of date or time related methods. This class is primarily used
 * for the conversion of ISO8601 time formats.
 * TODO this class should use net.sbbi.upnp.services.ISO8601Date, rather than Joda Time
 * @author David Wheeler
 * 
 */
public class TimeUtilities {

    private static final PeriodFormatter periodFormatter;

    static {
        PeriodFormatterBuilder builder = new PeriodFormatterBuilder();

        // TODO this will not work for fractional millis. which are stupid anyway.
        periodFormatter = builder.printZeroAlways().appendHours().minimumPrintedDigits(2).maximumParsedDigits(2)
                .appendSeparator(":").minimumPrintedDigits(2).appendMinutes().appendSeparator(":")
                .appendSecondsWithOptionalMillis().toFormatter();
    }

    /**
     * @param duration
     *          the UPNP representation of the duration
     * @return the java Date <code>long</code> style representation of the
     *         duration, or -1 if duration is NOT_IMPLEMENTED.
     */
    public static long convertDurationToLong(String duration) {
        if ("NOT_IMPLEMENTED".equals(duration) || "".equals(duration) || duration == null) {
            return -1;
        }
        // TODO there's also an "END_OF_MEDIA" thing...
        Period period = periodFormatter.parsePeriod(duration);
        return period.toDurationFrom(new Instant()).getMillis();
    }

    /**
     * TODO BUG durations longer than one day will not work
     * 
     * @param duration
     * @return A String of the following format: h:MM:ss[.m+]
     */
    public static String convertLongToDuration(long duration) {
        Period period = new Period(duration);
        return periodFormatter.print(period);
    }

    /**
     * Converts the given java date to an ISO8601 formatted date.
     * @param date
     * @return
     */
    public static String convertLongToISO8601Date(long date) {
        return new DateTime(date).toString();
    }

    /**
     * Parses the given ISO8601 formatted date into a java date.
     * @param date
     * @return
     * @throws IllegalArgumentException if date is not of ISO8601 date format
     */
    public static long convertISO8601DateToLong(String date) {
        return new DateTime(date).getMillis();
    }

    /**
     * Converts the given java date to an ISO8601 duration.
     * @param duration
     * @return
     */
    public static String convertLongToISO8601Duration(long duration) {
        return new Duration(duration).toString();
    }

    /**
     * Parses the given ISO8601 Duration formatted string to a java date.
     * @param duration
     * @return
     * @throws IllegalArgumentException if duration is not of ISO8601 duration format.
     */
    public static long convertISO8601DurationToLong(String duration) {
        return new Duration(duration).getMillis();
    }
}