feat: introduce toduration conversion function

conversion_functions.go

@@ -128,6 +128,23 @@ func (fh *FunctionHandler) ToDate(fmt, str string) time.Time {
 	return result
 }
 
+// ToDuration converts a value to a time.Duration.
+//
+// Parameters:
+//
+//	v any - the value to convert to time.Duration. This value can be a string, int, or another compatible type.
+//
+// Returns:
+//
+//	time.Duration - the duration representation of the value.
+//
+// Example:
+//
+//	{{ (toDuration "1h30m").Seconds }} // Output: 5400
+func (fh *FunctionHandler) ToDuration(v any) time.Duration {
+	return cast.ToDuration(v)
+}
+
 // MustToDate tries to parse a string into a time.Time object based on a format,
 // returning an error if parsing fails.
 //

conversion_functions_test.go

@@ -82,6 +82,19 @@ func TestToDate(t *testing.T) {
 	runTestCases(t, tests)
 }
 
+func TestToDuration(t *testing.T) {
+	var tests = testCases{
+		{"TestInt", `{{$v := toDuration .V }}{{typeOf $v}}-{{$v}}`, "time.Duration-1ns", map[string]any{"V": 1}},
+		{"TestInt32", `{{$v := toDuration .V }}{{typeOf $v}}-{{$v}}`, "time.Duration-1µs", map[string]any{"V": int32(1000)}},
+		{"TestFloat64", `{{$v := toDuration .V }}{{typeOf $v}}-{{$v}}`, "time.Duration-1.00042ms", map[string]any{"V": float64(1000 * 1000.42)}},
+		{"TestString", `{{$v := toDuration .V }}{{typeOf $v}}-{{$v}}`, "time.Duration-1m0s", map[string]any{"V": "1m"}},
+		{"TestInvalid", `{{$v := toDuration .V }}{{typeOf $v}}-{{$v}}`, "time.Duration-0s", map[string]any{"V": "aaaa"}},
+		{"TestCallingOnIt", `{{ (toDuration "1h30m").Seconds }}`, "5400", nil},
+	}
+
+	runTestCases(t, tests)
+}
+
 func TestMustToDate(t *testing.T) {
 	var tests = mustTestCases{
 		{testCase{"TestDate", `{{$v := mustToDate "2006-01-02" .V }}{{typeOf $v}}-{{$v}}`, "time.Time-2024-05-09 00:00:00 +0000 UTC", map[string]any{"V": "2024-05-09"}}, ""},

sprout.go

@@ -154,6 +154,7 @@ func FuncMap(opts ...FunctionHandlerOption) template.FuncMap {
 	fnHandler.funcMap["toFloat64"] = fnHandler.ToFloat64
 	fnHandler.funcMap["seq"] = fnHandler.Seq
 	fnHandler.funcMap["toOctal"] = fnHandler.ToOctal
+	fnHandler.funcMap["toDuration"] = fnHandler.ToDuration
 	fnHandler.funcMap["split"] = fnHandler.Split
 	fnHandler.funcMap["splitList"] = fnHandler.SplitList
 	fnHandler.funcMap["splitn"] = fnHandler.Splitn