// Copyright 2016 The Domain Registry Authors. All Rights Reserved. // // 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 google.registry.model.common; import static google.registry.util.DateTimeUtils.isAtOrAfter; import static google.registry.util.DateTimeUtils.isBeforeOrAt; import com.google.common.base.Splitter; import com.googlecode.objectify.annotation.Embed; import com.googlecode.objectify.annotation.Index; import google.registry.model.ImmutableObject; import org.joda.time.DateTime; import java.util.List; /** * A time of year (month, day, millis of day) that can be stored in a sort-friendly format. *

* This is conceptually similar to {@code MonthDay} in Joda or more generally to Joda's * {@code Partial}, but the parts we need are too simple to justify a full implementation of * {@code Partial}. *

* For simplicity, the native representation of this class's data is its stored format. This allows * it to be embeddable with no translation needed and also delays parsing of the string on load * until it's actually needed. */ @Embed public class TimeOfYear extends ImmutableObject { /** * The time as "month day millis" with all fields left-padded with zeroes so that lexographic * sorting will do the right thing. */ @Index String timeString; /** * Constructs a {@link TimeOfYear} from a {@link DateTime}. *

* This handles leap years in an intentionally peculiar way by always treating February 29 as * February 28. It is impossible to construct a {@link TimeOfYear} for February 29th. */ public static TimeOfYear fromDateTime(DateTime dateTime) { DateTime nextYear = dateTime.plusYears(1); // This turns February 29 into February 28. TimeOfYear instance = new TimeOfYear(); instance.timeString = String.format( "%02d %02d %08d", nextYear.getMonthOfYear(), nextYear.getDayOfMonth(), nextYear.getMillisOfDay()); return instance; } /** Get the first {@link DateTime} with this month/day/millis that is at or after the start. */ public DateTime atOrAfter(DateTime start) { DateTime withSameYear = getDateTimeWithSameYear(start); return isAtOrAfter(withSameYear, start) ? withSameYear : withSameYear.plusYears(1); } /** Get the first {@link DateTime} with this month/day/millis that is at or before the end. */ public DateTime beforeOrAt(DateTime end) { DateTime withSameYear = getDateTimeWithSameYear(end); return isBeforeOrAt(withSameYear, end) ? withSameYear : withSameYear.minusYears(1); } /** * Return a new datetime with the same year as the parameter but projected to the month, day, and * time of day of this object. */ private DateTime getDateTimeWithSameYear(DateTime date) { List monthDayMillis = Splitter.on(' ').splitToList(timeString); // Do not be clever and use Ints.stringConverter here. That does radix guessing, and bad things // will happen because of the leading zeroes. return date .withMonthOfYear(Integer.parseInt(monthDayMillis.get(0))) .withDayOfMonth(Integer.parseInt(monthDayMillis.get(1))) .withMillisOfDay(Integer.parseInt(monthDayMillis.get(2))); } }