Allow 'until' filters to accept formats as described in docs

[bunker-inspector]

- What I did
Added support for more until parameters for system prune --filter to match the docs: https://docs.docker.com/engine/reference/commandline/system_prune/
Fixes #40253

- How I did it
This attempts to interpret the user input as each supported format in order, accepting the first that doesn't return an error.

- How to verify it
Run docker system prune --force --all --filter "until=<ts-or-date-string>" using the listed supported formats from the docs

- Description for the changelog
system prune --filter "until" parameter allows all formats listed on in the docs

- A picture of a cute animal (not mandatory but encouraged)

[thaJeztah]

Thanks for contributing! Looking for how this is handled for the other "prune" endpoints, I noticed that there's already an implementation for this, so it may be better to use that one (see my comment inline); could you update your PR to use that?

(When updating, please amend your current commit so that there's a single commit in this PR, but feel to message me on the community slack if you need more instructions)

[thaJeztah]

Instead of implementing the parsing here, I think it would be better to use the same implementation as is used by the other endpoints (see the original implementation in #29226); https://github.com/moby/moby/blob/48cfe3f0872647bf0f52e6ba65022e1859e808e8/api/types/time/timestamp.go

(TBH, in hindsight, we should've done the parsing itself in the client, and always send a fixed format timestamp over the API, but I guess that's too late to change)

[bunker-inspector]

Good catch! I've updated it to use the method you've suggested.

[thaJeztah]

you can leave out the "else" here, because var nsecs int will already default to 0

But looking tat this part, isn't this doing the same as apitime. ParseTimestamps() ?

moby/api/types/time/timestamp.go

Lines 106 to 129 in 48cfe3f

	func ParseTimestamps(value string, def int64) (int64, int64, error) {
	if value == "" {
	return def, 0, nil
	}
	return parseTimestamp(value)
	}
	func parseTimestamp(value string) (int64, int64, error) {
	sa := strings.SplitN(value, ".", 2)
	s, err := strconv.ParseInt(sa[0], 10, 64)
	if err != nil {
	return s, 0, err
	}
	if len(sa) != 2 {
	return s, 0, nil
	}
	n, err := strconv.ParseInt(sa[1], 10, 64)
	if err != nil {
	return s, n, err
	}
	// should already be in nanoseconds but just in case convert n to nanoseconds
	n = int64(float64(n) * math.Pow(float64(10), float64(9-len(sa[1]))))
	return s, n, nil
	}

[thaJeztah]

The else looks redundant here, because we wouldn't reach this point if there was an error.

[git4lad]

is there any plan to merge this change ? if not are we planning to update the document to say we don't support date format ?