getSunrise() Function

That's really simple - tank you! Works, jim_m_58 !

Last question:
should I check if Time.now() has delivered a valid Moment? - or must it deliver a valid Moment anyway.

(As far I have learned, a Moment cannot be null ??)

I've never seen a case, including in ERA, where it's not a Moment.  For a watchface. Time.now() is commonly used to get the date and time to display..

mcinner1 said:

should I check if Time.now() has delivered a valid Moment? - or must it deliver a valid Moment anyway.

(As far I have learned, a Moment cannot be null ??)

“a Moment cannot be null ??”

This is the wrong question to ask. By definition, a Moment is a Moment, and not a null value.

The right question to ask is whether Time.now() can also return null (or throw an exception). And according to the documentation/typecheck data (and experience), the answer is no.

The docs type Time.now() as simply returning Moment.

[https://developer.garmin.com/connect-iq/api-docs/Toybox/Time.html#now-instance_function]

If Time.now() could return null, it would be typed as returning Moment or Null, not simply Moment. If it could throw an exception, the documentation would say so (hopefully). Ofc we could ask whether a System Error is possible here (as that’s sometimes not documented), but from experience that never happens (and it’s hard to imagine a case where it would.)

Another valid question would be “are there are any invalid Moment values” (and the answer to that should also “no”).

For a deeper answer, traditionally most computer systems will not return an invalid value (or throw an exception) when asked for the current (“wall clock”) time (and date), since this is a very basic function of computing. Obviously there are cases where the source of the time is not trusted, but typically there’s a separate function to determine that. For example, CIQ has Time.getCurrentTime() which allows you to select the time source (default, GPS or RTC). If RTC is selected and the RTC hasn’t been synced with GPS, then an exception will be thrown (because that indicates the RTC isn’t to be trusted.)

As a counter-example, in Java, Clock.instant() is documented as possibly throwing an exception, but the docs note that most implementations won’t throw it.

[https://docs.oracle.com/javase/8/docs/api/java/time/Clock.html#instant--]

flocsy🤠 said:

I'm not sure I understand your question. More precisely: what do you try to achieve?

I think mcinner1 wants to pass the current date/time to Weather.getSunrise(). Having been unaware of Time.now(), they used Weather.getCurrentConditions().observationTime to get the "current date/time" instead, but they correctly noted that observationTime will be unavailable in some cases.