I've been working on a translator to Python this week, and reviewing the JavaScript version of TimeUtil.js I see that overloaded methods don't translate well. For example, formatIso8601Time( int[] nn, int offset ) has a convenience method for the typical case where the offset is zero and it's just a seven-element time, with no offset specified: formatIso8601Time( int[] nn ). These overloaded methods don't translate into JavaScript and Python nicely, and should be avoided.
Other language features which fall into this category should also be documented here.
I've replaced the method which takes a 14-element timerange with formatIso8601TimeInTimeRangeBrief and formatIso8601TimeInTimeRange, so that it's more clear why they differ.
I've been working on a translator to Python this week, and reviewing the JavaScript version of TimeUtil.js I see that overloaded methods don't translate well. For example, formatIso8601Time( int[] nn, int offset ) has a convenience method for the typical case where the offset is zero and it's just a seven-element time, with no offset specified: formatIso8601Time( int[] nn ). These overloaded methods don't translate into JavaScript and Python nicely, and should be avoided.
Other language features which fall into this category should also be documented here.