[docs] Cloud Tasks: description needed for scheduleTime

[gregfenton]

Environment details

• OS: n/a
• Node.js version: all
• npm version: all
• google-cloud-node version: all

Steps to reproduce

The docs for Cloud Tasks do not give a description of what the meaning or (more importantly) value of scheduleTime is. There are several identical copies of code snippets in the examples, but it is not at all obvious what day/time/epoch the task is being scheduled for:

  if (inSeconds) {
    task.scheduleTime = {
      seconds: inSeconds + Date.now() / 1000,
    };
  }

unclear to me what seconds: 1671593022.414 (approximately, depending on when Date.now() is for you) means when it gets passed to client.createTask()

Would be very helpful to at least have a comment above each setting in each code sample. But a proper API document is required (if it exists, I am missing which link to follow).