Although that seems reasonable, I think given the new wording in the documentation, most users would expect to find such a transition in the year you call N+1, since that's when the actual onset of the transition occurs.
--
Tim Parenti
sent from my Android phone
Tim Parenti wrote:
I think there may be an
off-by-one from expected behavior: It includes transition times taking
effect at 01-01 00:00:00Z in the previous year, presumably because the
immediately prior second, included in the output, is 12-31 23:59:59Z.
Sorry, I didn't quite follow that. The intent is that if there's a transition between 12-31 23:59:59.999... UTC in year N and 01-01 00:00 UTC in year N+1, the transition is reported in year N. The other way would work too, as long as it was done consistently, but this way should be a bit easier to compute.