strfmt

package module
v0.27.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 16, 2026 License: Apache-2.0 Imports: 30 Imported by: 24,202

README

strfmt

Tests Coverage CI vuln scan CodeQL

Release Go Report Card CodeFactor Grade License

GoDoc Discord Channel go version Top language Commits since latest release

Golang support for string formats defined by JSON Schema and OpenAPI.

Announcements

  • 2026-03-07 : v0.26.0 dropped dependency to the mongodb driver
    • mongodb users can still use this package without any change
    • however, we have frozen the back-compatible support for mongodb driver at v2.5.0
    • users who want to keep-up with future evolutions (possibly incompatible) of this driver can do so by adding a blank import in their program: import _ "github.com/go-openapi/strfmt/enable/mongodb". This will switch the behavior to the actual driver, which remains regularly updated as an independent module.

Status

API is stable.

Import this library in your project

go get github.com/go-openapi/strfmt

Contents

This package exposes a registry of data types to support string formats in the go-openapi toolkit.

strfmt represents a well known string format such as hostname or email.

This package provides a few extra formats such as credit card (US), color, etc.

Format types can serialize and deserialize JSON or from a SQL database.

BSON is also supported (MongoDB).

Supported formats

go-openapi/strfmt follows the swagger 2.0 specification with the following formats defined here.

It also provides convenient extensions to go-openapi users.

  • JSON-schema draft 4 formats
    • date-time
    • email
    • hostname
    • ipv4
    • ipv6
    • uri
  • swagger 2.0 format extensions
    • binary
    • byte (e.g. base64 encoded string)
    • date (e.g. "1970-01-01")
    • password
  • go-openapi custom format extensions
    • bsonobjectid (BSON objectID)
    • creditcard
    • duration (e.g. "3 weeks", "1ms") (aka "duration-human")
    • hexcolor (e.g. "#FFFFFF")
    • isbn, isbn10, isbn13
    • mac (e.g "01:02:03:04:05:06")
    • rgbcolor (e.g. "rgb(100,100,100)")
    • ssn
    • uuid, uuid3, uuid4, uuid5, uuid7
    • cidr (e.g. "192.0.2.1/24", "2001:db8:a0b:12f0::1/32")
    • ulid (e.g. "00000PP9HGSBSSDZ1JTEXBJ0PW", spec)
  • JSON-schema draft 2020 formats
    • duration-iso8601 B(e.g. "P2W")

NOTE: as the name stands for, this package is intended to support string formatting only. It does not provide validation for numerical values with swagger format extension for JSON types "number" or "integer" (e.g. float, double, int32...).

Durations

We have 2 very different definitions of the "duration" format: the "human-readable" duration that used to be just "duration", and the new "duration-iso8601". There is no "dual" parser that accepts both formats: types are specialized.

To clarify the situation, a new alias for the duration format is introduced "duration-human" (e.g. "1 ms"), as opposed to "duration-iso8601".

The Default format registry wires "duration-human" as the default mapping for "duration" (preexisting behavior, no breaking change - aligned with Swagger 2.0 which did not define "duration").

A new JSONSchema2020 registry wires "duration-iso8601" as the default mapping for "duration".

Type conversion

All types defined here are stringers and may be converted to strings with .String(). Note that most types defined by this package may be converted directly to string like string(Email{}).

Date and DateTime may be converted directly to time.Time like time.Time(Time{}). Similarly, you can convert Duration to time.Duration as in time.Duration(Duration{})

Using pointers

The conv subpackage provides helpers to convert the types to and from pointers, just like go-openapi/swag does with primitive types.

Format types

Types defined in strfmt expose marshaling and validation capabilities.

List of defined types:

  • Base64
  • CreditCard
  • Date
  • DateTime
  • Duration
  • DurationISO8601 and ISODuration[P ISODurationPolicy] (for optional behavior)
  • Email
  • HexColor
  • Hostname
  • IPv4
  • IPv6
  • CIDR
  • ISBN
  • ISBN10
  • ISBN13
  • MAC
  • ObjectId
  • Password
  • RGBColor
  • SSN
  • URI
  • UUID
  • UUID3
  • UUID4
  • UUID5
  • UUID7
  • ULID
Database support

All format types implement the database/sql interfaces sql.Scanner and driver.Valuer, so they work out of the box with Go's standard database/sql package and any SQL driver.

All format types also implement BSON marshaling/unmarshaling for use with MongoDB. By default, a built-in minimal codec is used (compatible with mongo-driver v2.5.0). For full driver support, add import _ "github.com/go-openapi/strfmt/enable/mongodb".

MySQL / MariaDB caveat for DateTime: The go-sql-driver/mysql driver has hard-coded handling for time.Time but does not intercept type redefinitions like strfmt.DateTime. As a result, DateTime.Value() sends an RFC 3339 string (e.g. "2024-06-15T12:30:45.123Z") that MySQL/MariaDB rejects for DATETIME columns.

Workaround: set strfmt.MarshalFormat to a MySQL-compatible format such as strfmt.ISO8601LocalTime and normalize to UTC before marshaling:

strfmt.MarshalFormat = strfmt.ISO8601LocalTime
strfmt.NormalizeTimeForMarshal = func(t time.Time) time.Time { return t.UTC() }

See #174 for details.

Integration tests for MongoDB, MariaDB, and PostgreSQL run in CI to verify database roundtrip compatibility for all format types. See internal/testintegration/.

Change log

See https://github.com/go-openapi/strfmt/releases

References

https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md

Licensing

This library ships under the SPDX-License-Identifier: Apache-2.0.

Other documentation

Cutting a new release

Maintainers can cut a new release by either:

  • running this workflow
  • or pushing a semver tag
    • signed tags are preferred
    • The tag message is prepended to release notes

Documentation

Overview

Package strfmt contains custom string formats.

Index

Examples

Constants

View Source 
const (
	// UUIDPattern Regex for [UUID] that allows uppercase.
	//
	// Deprecated: [strfmt] no longer uses regular expressions to validate UUIDs.
	UUIDPattern = `(?i)(^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{32}$)`

	// UUID3Pattern Regex for [UUID3] that allows uppercase.
	//
	// Deprecated: [strfmt] no longer uses regular expressions to validate UUIDs.
	UUID3Pattern = `(?i)(^[0-9a-f]{8}-[0-9a-f]{4}-3[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12}$)|(^[0-9a-f]{12}3[0-9a-f]{3}?[0-9a-f]{16}$)`

	// UUID4Pattern Regex for [UUID4] that allows uppercase.
	//
	// Deprecated: [strfmt] no longer uses regular expressions to validate UUIDs.
	UUID4Pattern = `(?i)(^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$)|(^[0-9a-f]{12}4[0-9a-f]{3}[89ab][0-9a-f]{15}$)`

	// UUID5Pattern Regex for [UUID]5 that allows uppercase.
	//
	// Deprecated: [strfmt] no longer uses regular expressions to validate UUIDs.
	UUID5Pattern = `(?i)(^[0-9a-f]{8}-[0-9a-f]{4}-5[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$)|(^[0-9a-f]{12}5[0-9a-f]{3}[89ab][0-9a-f]{15}$)`
)
View Source 
const (
	// RFC3339Millis represents a ISO8601 format to millis instead of to nanos.
	RFC3339Millis = "2006-01-02T15:04:05.000Z07:00"
	// RFC3339MillisNoColon represents a ISO8601 format to millis instead of to nanos.
	RFC3339MillisNoColon = "2006-01-02T15:04:05.000Z0700"
	// RFC3339Micro represents a ISO8601 format to micro instead of to nano.
	RFC3339Micro = "2006-01-02T15:04:05.000000Z07:00"
	// RFC3339MicroNoColon represents a ISO8601 format to micro instead of to nano.
	RFC3339MicroNoColon = "2006-01-02T15:04:05.000000Z0700"
	// ISO8601LocalTime represents a ISO8601 format to ISO8601 in local time (no timezone).
	ISO8601LocalTime = "2006-01-02T15:04:05"
	// ISO8601TimeWithReducedPrecision represents a ISO8601 format with reduced precision (dropped secs).
	ISO8601TimeWithReducedPrecision = "2006-01-02T15:04Z"
	// ISO8601TimeWithReducedPrecisionLocaltime represents a ISO8601 format with reduced precision and no timezone (dropped seconds + no timezone).
	ISO8601TimeWithReducedPrecisionLocaltime = "2006-01-02T15:04"
	// ISO8601TimeUniversalSortableDateTimePattern represents a ISO8601 universal sortable date time pattern.
	ISO8601TimeUniversalSortableDateTimePattern = "2006-01-02 15:04:05"
	// ISO8601TimeUniversalSortableDateTimePatternShortForm is the short form of [ISO8601TimeUniversalSortableDateTimePattern].
	ISO8601TimeUniversalSortableDateTimePatternShortForm = "2006-01-02"
	// DateTimePattern pattern to match for the date-time format from http://tools.ietf.org/html/rfc3339#section-5.6
	DateTimePattern = `^([0-9]{2}):([0-9]{2}):([0-9]{2})(.[0-9]+)?(z|([+-][0-9]{2}:[0-9]{2}))$`
)
View Source 
const ErrFormat strfmtError = "format error"

ErrFormat is an error raised by the strfmt package.

View Source 
const (
	// HostnamePattern http://[json]-schema.org/latest/[json]-schema-validation.html#anchor114.
	//
	// Deprecated: this package no longer uses regular expressions to validate hostnames.
	HostnamePattern = `^([a-zA-Z0-9\p{S}\p{L}]((-?[a-zA-Z0-9\p{S}\p{L}]{0,62})?)` +
		`|([a-zA-Z0-9\p{S}\p{L}](([a-zA-Z0-9-\p{S}\p{L}]{0,61}[a-zA-Z0-9\p{S}\p{L}])?)(\.)){1,}([a-zA-Z0-9-\p{L}]){2,63})$`
)
View Source 
const (
	// RFC3339FullDate represents a full-date as specified by RFC3339.
	// See: http://goo.gl/xXOvVd
	RFC3339FullDate = "2006-01-02"
)

Variables

View Source 
var (

	// DateTimeFormats is the collection of formats used by [ParseDateTime]().
	DateTimeFormats = []string{
		RFC3339Micro, RFC3339MicroNoColon,
		RFC3339Millis, RFC3339MillisNoColon,
		time.RFC3339, time.RFC3339Nano,
		ISO8601LocalTime,
		ISO8601TimeWithReducedPrecision,
		ISO8601TimeWithReducedPrecisionLocaltime,
		ISO8601TimeUniversalSortableDateTimePattern,
		ISO8601TimeUniversalSortableDateTimePatternShortForm,
	}

	// MarshalFormat sets the time resolution format used for marshaling time (set to milliseconds).
	MarshalFormat = RFC3339Millis

	// NormalizeTimeForMarshal provides a normalization function on time before marshaling (e.g. [time.UTC]).
	// By default, the time value is not changed.
	NormalizeTimeForMarshal = func(t time.Time) time.Time { return t }

	// DefaultTimeLocation provides a location for a time when the time zone is not encoded in the string (ex: ISO8601 Local variants).
	DefaultTimeLocation = time.UTC
)
View Source 
var (

	// ULIDScanDefaultFunc is the default implementation for scanning a [ULID] from a database driver value.
	ULIDScanDefaultFunc = func(raw any) (ULID, error) {
		u := NewULIDZero()
		switch x := raw.(type) {
		case nil:

			return u, nil
		case string:
			if x == "" {

				return u, nil
			}
			return u, u.UnmarshalText([]byte(x))
		case []byte:
			return u, u.UnmarshalText(x)
		}

		return u, fmt.Errorf("cannot sql.Scan() strfmt.ULID from: %#v: %w", raw, ulid.ErrScanValue)
	}

	// ULIDScanOverrideFunc allows you to override the Scan method of the [ULID] type.
	ULIDScanOverrideFunc = ULIDScanDefaultFunc

	// ULIDValueDefaultFunc is the default implementation for converting a [ULID] to a database driver value.
	ULIDValueDefaultFunc = func(u ULID) (driver.Value, error) {
		return driver.Value(u.String()), nil
	}

	// ULIDValueOverrideFunc allows you to override the Value method of the [ULID] type.
	ULIDValueOverrideFunc = ULIDValueDefaultFunc
)
View Source 
var UnixZero = time.Unix(0, 0).UTC() //nolint:gochecknoglobals // package-level sentinel value for unix epoch

UnixZero sets the zero unix UTC timestamp we want to compare against.

Unix 0 for an EST timezone is not equivalent to a UTC timezone.

Functions

func DefaultNameNormalizer 

func DefaultNameNormalizer(name string) string

DefaultNameNormalizer removes all dashes.

func IsBSONObjectID 

func IsBSONObjectID(str string) bool

IsBSONObjectID returns true when the string is a valid BSON ObjectId.

func IsCountry added in v0.27.0 

func IsCountry(str string) bool

IsCountry checks if a string is a valid ISO 3166 country format.

func IsCurrency added in v0.27.0 

func IsCurrency(str string) bool

IsCurrency checks if a string is a valid currency format.

func IsDate 

func IsDate(str string) bool

IsDate returns true when the string is a valid date.

func IsDateTime 

func IsDateTime(str string) bool

IsDateTime returns true when the string is a valid date-time.

JSON datetime format consist of a date and a time separated by a "T", e.g. 2012-04-23T18:25:43.511Z.

func IsDuration 

func IsDuration(str string) bool

IsDuration returns true if the provided string is a valid duration.

func IsDurationISO8601 added in v0.27.0 

func IsDurationISO8601(s string) bool

IsDurationISO8601 returns true if the string is a valid strict ISO 8601 duration.

func IsEmail added in v0.17.1 

func IsEmail(str string) bool

IsEmail validates an email address.

func IsHostname 

func IsHostname(str string) bool

IsHostname returns true when the string is a valid hostname.

It follows the rules detailed at https://url.spec.whatwg.org/#concept-host-parser and implemented by most modern web browsers.

It supports IDNA rules regarding internationalized names with unicode.

Besides:

  • the empty string is not a valid host name
  • a trailing dot is allowed in names and IPv4's (not IPv6)
  • a host name can be a valid IPv4 (with decimal, octal or hexadecimal numbers) or IPv6 address
  • IPv6 zones are disallowed
  • top-level domains can be unicode (cf. https://www.iana.org/domains/root/db).

NOTE: this validator doesn't check top-level domains against the IANA root database. It merely ensures that a top-level domain in a FQDN is at least 2 code points long.

func IsULID added in v0.20.1 

func IsULID(str string) bool

IsULID checks if provided string is ULID format Be noticed that this function considers overflowed ULID as non-ulid. For more details see https://github.com/ulid/spec

func IsUUID 

func IsUUID(str string) bool

IsUUID returns true if the string matches a UUID (in any version, including v6 and v7), upper case is allowed.

func IsUUID3 

func IsUUID3(str string) bool

IsUUID3 returns true if the string matches a UUID v3, upper case is allowed.

func IsUUID4 

func IsUUID4(str string) bool

IsUUID4 returns true is the string matches a UUID v4, upper case is allowed.

func IsUUID5 

func IsUUID5(str string) bool

IsUUID5 returns true if the string matches a UUID v5, upper case is allowed.

func IsUUID7 added in v0.25.0 

func IsUUID7(str string) bool

IsUUID7 returns true if the string matches a UUID v7, upper case is allowed.

func JSONSchema2020Normalizer added in v0.27.0 

func JSONSchema2020Normalizer(name string) string

JSONSchema2020Normalizer is like NameNormalizer but adopts "duration-iso8601" as the default "duration" format.

func ParseDuration 

func ParseDuration(s string) (time.Duration, error)

ParseDuration parses a duration from a string

It is similar to time.ParseDuration but support additional units like days and weeks, additional abreviations for units and is more tolerant on the presence of blank spaces.

A duration may be negative or fractional.

Differences with [time.ParseDuration]

  • more supported units and aliases (see below)
  • sign followed by blank space is tolerated
  • tolerates blanks between duration and unit (e.g. "300 ms")

Supported units

Units may be specified using aliases or a plural form.

  • "ns", "nano", "nanosecond", "nanoseconds", "nanos"
  • "us", "µs" (U+00B5 = micro symbol), "μs" (U+03BC = Greek letter mu), "micro", "micros", "microsecond", "microseconds"
  • "ms", "milli", "millis", "millisecond", "milliseconds"
  • "s", "sec", "secs", "second", "seconds"
  • "m", "min", "mins", "minute", "minutes"
  • "h", "hr", "hrs", "hour", "hours"
  • "d", "day", "days"
  • "w", "wk", "wks", "week", "weeks"

NOTE: inspired by scala duration syntax.

Examples

"300ms", "-1.5h", "2h45m", ".5 week", "2 minutes 45 seconds".

func ParseISO8601Duration added in v0.27.0 

func ParseISO8601Duration(s string, opts ...ISODurationOption) (time.Duration, error)

ParseISO8601Duration parses an ISO 8601 / RFC 3339 duration string.

With no options it enforces the strict RFC 3339 Appendix A grammar. Options relax individual rules for programmatic callers.

Example

The strict parser accepts the RFC 3339 Appendix A grammar (the JSON Schema "duration" format) and returns an ordinary time.Duration. Calendar units are collapsed to fixed lengths (year = 365 days, month = 30 days). 

package main

import (
	"errors"
	"fmt"

	"github.com/go-openapi/strfmt"
)

func main() {
	d, err := strfmt.ParseISO8601Duration("P1DT12H")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(d)

	// The strict grammar rejects fractions, signs and whitespace; every rejection
	// wraps strfmt.ErrFormat.
	_, err = strfmt.ParseISO8601Duration("PT0.5S")
	fmt.Println(errors.Is(err, strfmt.ErrFormat))

}

Output:
36h0m0s
true
Example (Options)

Options relax individual rules on the explicit ParseISO8601Duration path only — never the registry or struct-field decode path, which stays strict and unambiguous. 

package main

import (
	"fmt"

	"github.com/go-openapi/strfmt"
)

func main() {
	// A decimal fraction on the least significant component is opt-in.
	frac, _ := strfmt.ParseISO8601Duration("PT0.5S", strfmt.WithISOFractions())
	fmt.Println(frac)

	// A leading sign is opt-in.
	neg, _ := strfmt.ParseISO8601Duration("-PT1H", strfmt.WithISOSign())
	fmt.Println(neg)

	// WithISOLenient turns on every relaxation at once (fraction, sign, whitespace,
	// non-contiguous components, combinable "W"). Ordering is still enforced.
	lenient, _ := strfmt.ParseISO8601Duration("  P1Y2D  ", strfmt.WithISOLenient())
	fmt.Println(lenient)

}

Output:
500ms
-1h0m0s
8808h0m0s

Types

type Base64 

type Base64 []byte

Base64 represents a base64 encoded string, using the standard RFC 4648 alphabet.

swagger:strfmt byte.

func (*Base64) DeepCopy added in v0.19.0 

func (b *Base64) DeepCopy() *Base64

DeepCopy copies the receiver into a new Base64.

func (*Base64) DeepCopyInto added in v0.19.0 

func (b *Base64) DeepCopyInto(out *Base64)

DeepCopyInto copies the receiver and writes its value into out.

func (Base64) MarshalBSON added in v0.19.2 

func (b Base64) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Base64) MarshalJSON 

func (b Base64) MarshalJSON() ([]byte, error)

MarshalJSON returns the Base64 as JSON.

func (Base64) MarshalText 

func (b Base64) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*Base64) Scan 

func (b *Base64) Scan(raw any) error

Scan read a value from a database driver.

func (Base64) String 

func (b Base64) String() string

func (*Base64) UnmarshalBSON added in v0.19.2 

func (b *Base64) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Base64) UnmarshalJSON 

func (b *Base64) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Base64 from JSON.

func (*Base64) UnmarshalText 

func (b *Base64) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Base64) Value 

func (b Base64) Value() (driver.Value, error)

Value converts a value to a database driver value.

type CIDR added in v0.19.0 

type CIDR string

CIDR represents a Classless Inter-Domain Routing notation.

swagger:strfmt cidr.

func (*CIDR) DeepCopy added in v0.19.0 

func (u *CIDR) DeepCopy() *CIDR

DeepCopy copies the receiver into a new CIDR.

func (*CIDR) DeepCopyInto added in v0.19.0 

func (u *CIDR) DeepCopyInto(out *CIDR)

DeepCopyInto copies the receiver and writes its value into out.

func (CIDR) MarshalBSON added in v0.19.2 

func (u CIDR) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (CIDR) MarshalJSON added in v0.19.0 

func (u CIDR) MarshalJSON() ([]byte, error)

MarshalJSON returns the CIDR as JSON.

func (CIDR) MarshalText added in v0.19.0 

func (u CIDR) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*CIDR) Scan added in v0.19.0 

func (u *CIDR) Scan(raw any) error

Scan read a value from a database driver.

func (CIDR) String added in v0.19.0 

func (u CIDR) String() string

func (*CIDR) UnmarshalBSON added in v0.19.2 

func (u *CIDR) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*CIDR) UnmarshalJSON added in v0.19.0 

func (u *CIDR) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the CIDR from JSON.

func (*CIDR) UnmarshalText added in v0.19.0 

func (u *CIDR) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (CIDR) Value added in v0.19.0 

func (u CIDR) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Country added in v0.27.0 

type Country struct {
	countries.Country
	// contains filtered or unexported fields
}

Country represents an ISO 3166 country alpha-3 or alpha-2 code as a string format.

swagger:strfmt country.

func ParseCountry added in v0.27.0 

func ParseCountry(str string) (Country, error)

ParseCountry parses a string that represents a valid Country.

func (*Country) DeepCopy added in v0.27.0 

func (u *Country) DeepCopy() *Country

DeepCopy copies the receiver into a new Country.

func (*Country) DeepCopyInto added in v0.27.0 

func (u *Country) DeepCopyInto(out *Country)

DeepCopyInto copies the receiver and writes its value into out.

func (*Country) GobDecode added in v0.27.0 

func (u *Country) GobDecode(data []byte) error

GobDecode implements the gob.GobDecoder interface.

func (Country) GobEncode added in v0.27.0 

func (u Country) GobEncode() ([]byte, error)

GobEncode implements the gob.GobEncoder interface.

func (Country) MarshalBSON added in v0.27.0 

func (u Country) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Country) MarshalBinary added in v0.27.0 

func (u Country) MarshalBinary() ([]byte, error)

MarshalBinary implements the encoding.encoding.BinaryMarshaler interface.

func (Country) MarshalJSON added in v0.27.0 

func (u Country) MarshalJSON() ([]byte, error)

MarshalJSON returns the Country as JSON.

func (Country) MarshalText added in v0.27.0 

func (u Country) MarshalText() ([]byte, error)

MarshalText returns this instance into text.

func (*Country) Scan added in v0.27.0 

func (u *Country) Scan(raw any) error

Scan read a value from a database driver.

func (Country) String added in v0.27.0 

func (u Country) String() string

func (*Country) UnmarshalBSON added in v0.27.0 

func (u *Country) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Country) UnmarshalBinary added in v0.27.0 

func (u *Country) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the encoding.encoding.BinaryUnmarshaler interface.

func (*Country) UnmarshalJSON added in v0.27.0 

func (u *Country) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Country from JSON.

func (*Country) UnmarshalText added in v0.27.0 

func (u *Country) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Country) Value added in v0.27.0 

func (u Country) Value() (driver.Value, error)

Value converts a value to a database driver value.

type CreditCard 

type CreditCard string

CreditCard represents a credit card string format.

swagger:strfmt creditcard.

func (*CreditCard) DeepCopy added in v0.19.0 

func (u *CreditCard) DeepCopy() *CreditCard

DeepCopy copies the receiver into a new CreditCard.

func (*CreditCard) DeepCopyInto added in v0.19.0 

func (u *CreditCard) DeepCopyInto(out *CreditCard)

DeepCopyInto copies the receiver and writes its value into out.

func (CreditCard) MarshalBSON added in v0.19.2 

func (u CreditCard) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (CreditCard) MarshalJSON 

func (u CreditCard) MarshalJSON() ([]byte, error)

MarshalJSON returns the CreditCard as JSON.

func (CreditCard) MarshalText 

func (u CreditCard) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*CreditCard) Scan 

func (u *CreditCard) Scan(raw any) error

Scan read a value from a database driver.

func (CreditCard) String 

func (u CreditCard) String() string

func (*CreditCard) UnmarshalBSON added in v0.19.2 

func (u *CreditCard) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*CreditCard) UnmarshalJSON 

func (u *CreditCard) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the CreditCard from JSON.

func (*CreditCard) UnmarshalText 

func (u *CreditCard) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (CreditCard) Value 

func (u CreditCard) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Currency added in v0.27.0 

type Currency struct {
	currency.Unit
}

Currency represents an ISO 4217 currency alpha-3 code as a string format.

Implementation

golang.org/x/text/currency

swagger:strfmt currency.

func ParseCurrency added in v0.27.0 

func ParseCurrency(str string) (Currency, error)

ParseCurrency parses a string that represents a valid Currency.

func (*Currency) DeepCopy added in v0.27.0 

func (u *Currency) DeepCopy() *Currency

DeepCopy copies the receiver into a new Currency.

func (*Currency) DeepCopyInto added in v0.27.0 

func (u *Currency) DeepCopyInto(out *Currency)

DeepCopyInto copies the receiver and writes its value into out.

func (*Currency) GobDecode added in v0.27.0 

func (u *Currency) GobDecode(data []byte) error

GobDecode implements the gob.GobDecoder interface.

func (Currency) GobEncode added in v0.27.0 

func (u Currency) GobEncode() ([]byte, error)

GobEncode implements the gob.GobEncoder interface.

func (Currency) MarshalBSON added in v0.27.0 

func (u Currency) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Currency) MarshalBinary added in v0.27.0 

func (u Currency) MarshalBinary() ([]byte, error)

MarshalBinary implements the encoding.encoding.BinaryMarshaler interface.

func (Currency) MarshalJSON added in v0.27.0 

func (u Currency) MarshalJSON() ([]byte, error)

MarshalJSON returns the Currency as JSON.

func (Currency) MarshalText added in v0.27.0 

func (u Currency) MarshalText() ([]byte, error)

MarshalText returns this instance into text.

func (*Currency) Scan added in v0.27.0 

func (u *Currency) Scan(raw any) error

Scan read a value from a database driver.

func (Currency) String added in v0.27.0 

func (u Currency) String() string

func (*Currency) UnmarshalBSON added in v0.27.0 

func (u *Currency) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Currency) UnmarshalBinary added in v0.27.0 

func (u *Currency) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the encoding.encoding.BinaryUnmarshaler interface.

func (*Currency) UnmarshalJSON added in v0.27.0 

func (u *Currency) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Currency from JSON.

func (*Currency) UnmarshalText added in v0.27.0 

func (u *Currency) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Currency) Value added in v0.27.0 

func (u Currency) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Date 

type Date time.Time

Date represents a date from the API.

swagger:strfmt date.

func (*Date) DeepCopy added in v0.19.0 

func (d *Date) DeepCopy() *Date

DeepCopy copies the receiver into a new Date.

func (*Date) DeepCopyInto added in v0.19.0 

func (d *Date) DeepCopyInto(out *Date)

DeepCopyInto copies the receiver and writes its value into out.

func (Date) Equal added in v0.19.12 

func (d Date) Equal(d2 Date) bool

Equal checks if two Date instances are equal.

func (*Date) GobDecode added in v0.19.4 

func (d *Date) GobDecode(data []byte) error

GobDecode implements the gob.GobDecoder interface.

func (Date) GobEncode added in v0.19.4 

func (d Date) GobEncode() ([]byte, error)

GobEncode implements the gob.GobEncoder interface.

func (Date) MarshalBSON added in v0.19.2 

func (d Date) MarshalBSON() ([]byte, error)

func (Date) MarshalBinary added in v0.19.4 

func (d Date) MarshalBinary() ([]byte, error)

MarshalBinary implements the encoding.encoding.BinaryMarshaler interface.

func (Date) MarshalJSON 

func (d Date) MarshalJSON() ([]byte, error)

MarshalJSON returns the Date as JSON.

func (Date) MarshalText 

func (d Date) MarshalText() ([]byte, error)

MarshalText serializes this date type to string.

func (*Date) Scan 

func (d *Date) Scan(raw any) error

Scan scans a Date value from database driver type.

func (Date) String 

func (d Date) String() string

String converts this date into a string.

func (*Date) UnmarshalBSON added in v0.19.2 

func (d *Date) UnmarshalBSON(data []byte) error

func (*Date) UnmarshalBinary added in v0.19.4 

func (d *Date) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the encoding.encoding.BinaryUnmarshaler interface.

func (*Date) UnmarshalJSON 

func (d *Date) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Date from JSON.

func (*Date) UnmarshalText 

func (d *Date) UnmarshalText(text []byte) error

UnmarshalText parses a text representation into a date type.

func (Date) Value 

func (d Date) Value() (driver.Value, error)

Value converts Date to a primitive value ready to written to a database.

type DateTime 

type DateTime time.Time

DateTime is a time but it serializes to ISO8601 format with millis.

It knows how to read 3 different variations of a RFC3339 date time. Most APIs we encounter want either millisecond or second precision times. This just tries to make it worry-free.

swagger:strfmt date-time.

func MakeDateTime added in v0.24.0 

func MakeDateTime() DateTime

MakeDateTime is a representation of the zero value of the DateTime type (January 1, year 1, 00:00:00 UTC).

You may use DateTime.IsZero to check against this value.

func NewDateTime 

func NewDateTime() DateTime

NewDateTime is a representation of the UNIX epoch (January 1, 1970 00:00:00 UTC) for the DateTime type.

Notice that this is not the zero value of the DateTime type.

You may use DateTime.IsUnixZero to check against this value.

func ParseDateTime 

func ParseDateTime(data string) (DateTime, error)

ParseDateTime parses a string that represents an ISO8601 time or a unix epoch.

func (*DateTime) DeepCopy added in v0.19.0 

func (t *DateTime) DeepCopy() *DateTime

DeepCopy copies the receiver into a new DateTime.

func (*DateTime) DeepCopyInto added in v0.19.0 

func (t *DateTime) DeepCopyInto(out *DateTime)

DeepCopyInto copies the receiver and writes its value into out.

func (DateTime) Equal added in v0.19.12 

func (t DateTime) Equal(t2 DateTime) bool

Equal checks if two DateTime instances are equal using time.Time's Equal method.

func (*DateTime) GobDecode added in v0.19.4 

func (t *DateTime) GobDecode(data []byte) error

GobDecode implements the gob.GobDecoder interface.

func (DateTime) GobEncode added in v0.19.4 

func (t DateTime) GobEncode() ([]byte, error)

GobEncode implements the gob.GobEncoder interface.

func (DateTime) IsUnixZero added in v0.21.4 

func (t DateTime) IsUnixZero() bool

IsUnixZero returns whether the date time is equivalent to time.Unix(0, 0).UTC().

func (DateTime) IsZero added in v0.21.4 

func (t DateTime) IsZero() bool

IsZero returns whether the date time is a zero value.

func (DateTime) MarshalBSON added in v0.19.2 

func (t DateTime) MarshalBSON() ([]byte, error)

MarshalBSON renders the DateTime as a BSON document.

func (DateTime) MarshalBSONValue added in v0.19.4 

func (t DateTime) MarshalBSONValue() (byte, []byte, error)

MarshalBSONValue marshals a DateTime as a BSON DateTime value (type 0x09), an int64 representing milliseconds since epoch.

MarshalBSONValue is an interface implemented by types that can marshal themselves into a BSON document represented as bytes.

The bytes returned must be a valid BSON document if the error is nil.

func (DateTime) MarshalBinary added in v0.19.4 

func (t DateTime) MarshalBinary() ([]byte, error)

MarshalBinary implements the encoding.encoding.BinaryMarshaler interface.

func (DateTime) MarshalJSON 

func (t DateTime) MarshalJSON() ([]byte, error)

MarshalJSON returns the DateTime as JSON.

func (DateTime) MarshalText 

func (t DateTime) MarshalText() ([]byte, error)

MarshalText implements the text marshaler interface.

func (*DateTime) Scan 

func (t *DateTime) Scan(raw any) error

Scan scans a DateTime value from database driver type.

func (DateTime) String 

func (t DateTime) String() string

String converts this time to a string.

func (*DateTime) UnmarshalBSON added in v0.19.2 

func (t *DateTime) UnmarshalBSON(data []byte) error

UnmarshalBSON reads the DateTime from a BSON document.

func (*DateTime) UnmarshalBSONValue added in v0.19.4 

func (t *DateTime) UnmarshalBSONValue(tpe byte, data []byte) error

UnmarshalBSONValue unmarshals a BSON DateTime value into this DateTime.

func (*DateTime) UnmarshalBinary added in v0.19.4 

func (t *DateTime) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the encoding.encoding.BinaryUnmarshaler interface.

func (*DateTime) UnmarshalJSON 

func (t *DateTime) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the DateTime from JSON.

func (*DateTime) UnmarshalText 

func (t *DateTime) UnmarshalText(text []byte) error

UnmarshalText implements the text unmarshaler interface.

func (DateTime) Value 

func (t DateTime) Value() (driver.Value, error)

Value converts DateTime to a primitive value ready to written to a database.

type Duration 

type Duration time.Duration

Duration represents a duration

Duration stores a period of time as a nanosecond count, with the largest representable duration being approximately 290 years.

swagger:strfmt duration.

func (*Duration) DeepCopy added in v0.19.0 

func (d *Duration) DeepCopy() *Duration

DeepCopy copies the receiver into a new Duration.

func (*Duration) DeepCopyInto added in v0.19.0 

func (d *Duration) DeepCopyInto(out *Duration)

DeepCopyInto copies the receiver and writes its value into out.

func (Duration) MarshalBSON added in v0.19.2 

func (d Duration) MarshalBSON() ([]byte, error)

func (Duration) MarshalJSON 

func (d Duration) MarshalJSON() ([]byte, error)

MarshalJSON returns the Duration as JSON.

func (Duration) MarshalText 

func (d Duration) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*Duration) Scan 

func (d *Duration) Scan(raw any) error

Scan reads a Duration value from database driver type.

func (Duration) String 

func (d Duration) String() string

String converts this duration to a string.

func (*Duration) UnmarshalBSON added in v0.19.2 

func (d *Duration) UnmarshalBSON(data []byte) error

func (*Duration) UnmarshalJSON 

func (d *Duration) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Duration from JSON.

func (*Duration) UnmarshalText 

func (d *Duration) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Duration) Value 

func (d Duration) Value() (driver.Value, error)

Value converts Duration to a primitive value ready to be written to a database.

type DurationISO8601 added in v0.27.0 

type DurationISO8601 = ISODuration[DurationStrict]

DurationISO8601 is the strict, spec-compliant ISO 8601 duration: the JSON Schema draft 2020 "duration" format (RFC 3339 Appendix A).

It binds to the explicit, unambiguous "duration-iso8601" handle. Plain "duration" is a context-dependent default resolved by the registry (Default → human, JSONSchema2020Registry → ISO), not by this static type.

swagger:strfmt duration-iso8601.

Example (Json)

DurationISO8601 is the strict alias; it round-trips through JSON as a canonical ISO 8601 string. 

package main

import (
	"encoding/json"
	"fmt"
	"time"

	"github.com/go-openapi/strfmt"
)

func main() {
	type Payload struct {
		Timeout strfmt.DurationISO8601 `json:"timeout"`
	}

	var p Payload
	if err := json.Unmarshal([]byte(`{"timeout":"PT1H30M"}`), &p); err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(time.Duration(p.Timeout))

	out, err := json.Marshal(p)
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(string(out))

}

Output:
1h30m0s
{"timeout":"PT1H30M"}
Example (Registry)

The format is registered in the Default registry under the "duration-iso8601" handle, distinct from the human-readable "duration" format. 

package main

import (
	"fmt"

	"github.com/go-openapi/strfmt"
)

func main() {
	// A plain week duration is valid; strict "W" is exclusive, so combining it is rejected.
	fmt.Println(strfmt.Default.Validates("duration-iso8601", "P2W"))
	fmt.Println(strfmt.Default.Validates("duration-iso8601", "P2W3D")) // invalid
	fmt.Println()
	fmt.Println(strfmt.Default.Validates("duration", "2 weeks")) // human duration is the default for duration
	fmt.Println(strfmt.Default.Validates("duration", "P2W"))     // iso8601 is NOT the default for duration
	fmt.Println()
	fmt.Println(strfmt.JSONSchema2020Registry.Validates("duration", "P2W"))           // iso8601 is the duration for [JSONSchema2020Registry]
	fmt.Println(strfmt.JSONSchema2020Registry.Validates("duration", "2 weeks"))       // human duration is NOT the default duration for JSONSchema 2020
	fmt.Println(strfmt.JSONSchema2020Registry.Validates("duration-human", "2 weeks")) // human duration remain supported as an explicit format

}

Output:
true
false

true
false

true
false
true

type DurationLenient added in v0.27.0 

type DurationLenient struct{}

DurationLenient relaxes every strictness knob.

It accepts a decimal fraction on the least significant component, a leading sign, surrounding whitespace, component chains with gaps (e.g. P1Y2D), and a 'W' designator combined with other components.

It remains ordered (P2D1Y is still rejected).

type DurationStrict added in v0.27.0 

type DurationStrict struct{}

DurationStrict is the strict RFC 3339 Appendix A policy.

This is the grammar that the JSON Schema "duration" format is defined against (draft 2020): no fraction, no sign, no whitespace, strict ordering and anchoring, and an exclusive 'W' designator.

type Email 

type Email string

Email represents the email string format as specified by the json schema spec.

swagger:strfmt email.

func (*Email) DeepCopy added in v0.19.0 

func (e *Email) DeepCopy() *Email

DeepCopy copies the receiver into a new Email.

func (*Email) DeepCopyInto added in v0.19.0 

func (e *Email) DeepCopyInto(out *Email)

DeepCopyInto copies the receiver and writes its value into out.

func (Email) MarshalBSON added in v0.19.2 

func (e Email) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Email) MarshalJSON 

func (e Email) MarshalJSON() ([]byte, error)

MarshalJSON returns the Email as JSON.

func (Email) MarshalText 

func (e Email) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*Email) Scan 

func (e *Email) Scan(raw any) error

Scan read a value from a database driver.

func (Email) String 

func (e Email) String() string

func (*Email) UnmarshalBSON added in v0.19.2 

func (e *Email) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Email) UnmarshalJSON 

func (e *Email) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Email from JSON.

func (*Email) UnmarshalText 

func (e *Email) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Email) Value 

func (e Email) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Format 

type Format interface {
	String() string
	encoding.TextMarshaler
	encoding.TextUnmarshaler
}

Format represents a string format.

All implementations of Format provide a string representation and text marshaling/unmarshaling interface to be used by encoders (e.g. encoding/json).

type HexColor 

type HexColor string

HexColor represents a hex color string format.

swagger:strfmt hexcolor.

func (*HexColor) DeepCopy added in v0.19.0 

func (h *HexColor) DeepCopy() *HexColor

DeepCopy copies the receiver into a new HexColor.

func (*HexColor) DeepCopyInto added in v0.19.0 

func (h *HexColor) DeepCopyInto(out *HexColor)

DeepCopyInto copies the receiver and writes its value into out.

func (HexColor) MarshalBSON added in v0.19.2 

func (h HexColor) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (HexColor) MarshalJSON 

func (h HexColor) MarshalJSON() ([]byte, error)

MarshalJSON returns the HexColor as JSON.

func (HexColor) MarshalText 

func (h HexColor) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*HexColor) Scan 

func (h *HexColor) Scan(raw any) error

Scan read a value from a database driver.

func (HexColor) String 

func (h HexColor) String() string

func (*HexColor) UnmarshalBSON added in v0.19.2 

func (h *HexColor) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*HexColor) UnmarshalJSON 

func (h *HexColor) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the HexColor from JSON.

func (*HexColor) UnmarshalText 

func (h *HexColor) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (HexColor) Value 

func (h HexColor) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Hostname 

type Hostname string

Hostname represents the hostname string format as specified by the json schema spec.

swagger:strfmt hostname.

func (*Hostname) DeepCopy added in v0.19.0 

func (h *Hostname) DeepCopy() *Hostname

DeepCopy copies the receiver into a new Hostname.

func (*Hostname) DeepCopyInto added in v0.19.0 

func (h *Hostname) DeepCopyInto(out *Hostname)

DeepCopyInto copies the receiver and writes its value into out.

func (Hostname) MarshalBSON added in v0.19.2 

func (h Hostname) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Hostname) MarshalJSON 

func (h Hostname) MarshalJSON() ([]byte, error)

MarshalJSON returns the Hostname as JSON.

func (Hostname) MarshalText 

func (h Hostname) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*Hostname) Scan 

func (h *Hostname) Scan(raw any) error

Scan read a value from a database driver.

func (Hostname) String 

func (h Hostname) String() string

func (*Hostname) UnmarshalBSON added in v0.19.2 

func (h *Hostname) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Hostname) UnmarshalJSON 

func (h *Hostname) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Hostname from JSON.

func (*Hostname) UnmarshalText 

func (h *Hostname) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Hostname) Value 

func (h Hostname) Value() (driver.Value, error)

Value converts a value to a database driver value.

type IPv4 

type IPv4 string

IPv4 represents an IP v4 address.

swagger:strfmt ipv4.

func (*IPv4) DeepCopy added in v0.19.0 

func (u *IPv4) DeepCopy() *IPv4

DeepCopy copies the receiver into a new IPv4.

func (*IPv4) DeepCopyInto added in v0.19.0 

func (u *IPv4) DeepCopyInto(out *IPv4)

DeepCopyInto copies the receiver and writes its value into out.

func (IPv4) MarshalBSON added in v0.19.2 

func (u IPv4) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (IPv4) MarshalJSON 

func (u IPv4) MarshalJSON() ([]byte, error)

MarshalJSON returns the IPv4 as JSON.

func (IPv4) MarshalText 

func (u IPv4) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*IPv4) Scan 

func (u *IPv4) Scan(raw any) error

Scan read a value from a database driver.

func (IPv4) String 

func (u IPv4) String() string

func (*IPv4) UnmarshalBSON added in v0.19.2 

func (u *IPv4) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*IPv4) UnmarshalJSON 

func (u *IPv4) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the IPv4 from JSON.

func (*IPv4) UnmarshalText 

func (u *IPv4) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (IPv4) Value 

func (u IPv4) Value() (driver.Value, error)

Value converts a value to a database driver value.

type IPv6 

type IPv6 string

IPv6 represents an IP v6 address.

swagger:strfmt ipv6.

func (*IPv6) DeepCopy added in v0.19.0 

func (u *IPv6) DeepCopy() *IPv6

DeepCopy copies the receiver into a new IPv6.

func (*IPv6) DeepCopyInto added in v0.19.0 

func (u *IPv6) DeepCopyInto(out *IPv6)

DeepCopyInto copies the receiver and writes its value into out.

func (IPv6) MarshalBSON added in v0.19.2 

func (u IPv6) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (IPv6) MarshalJSON 

func (u IPv6) MarshalJSON() ([]byte, error)

MarshalJSON returns the IPv6 as JSON.

func (IPv6) MarshalText 

func (u IPv6) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*IPv6) Scan 

func (u *IPv6) Scan(raw any) error

Scan read a value from a database driver.

func (IPv6) String 

func (u IPv6) String() string

func (*IPv6) UnmarshalBSON added in v0.19.2 

func (u *IPv6) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*IPv6) UnmarshalJSON 

func (u *IPv6) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the IPv6 from JSON.

func (*IPv6) UnmarshalText 

func (u *IPv6) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (IPv6) Value 

func (u IPv6) Value() (driver.Value, error)

Value converts a value to a database driver value.

type ISBN 

type ISBN string

ISBN represents an isbn string format.

swagger:strfmt isbn.

func (*ISBN) DeepCopy added in v0.19.0 

func (u *ISBN) DeepCopy() *ISBN

DeepCopy copies the receiver into a new ISBN.

func (*ISBN) DeepCopyInto added in v0.19.0 

func (u *ISBN) DeepCopyInto(out *ISBN)

DeepCopyInto copies the receiver and writes its value into out.

func (ISBN) MarshalBSON added in v0.19.2 

func (u ISBN) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (ISBN) MarshalJSON 

func (u ISBN) MarshalJSON() ([]byte, error)

MarshalJSON returns the ISBN as JSON.

func (ISBN) MarshalText 

func (u ISBN) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*ISBN) Scan 

func (u *ISBN) Scan(raw any) error

Scan read a value from a database driver.

func (ISBN) String 

func (u ISBN) String() string

func (*ISBN) UnmarshalBSON added in v0.19.2 

func (u *ISBN) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*ISBN) UnmarshalJSON 

func (u *ISBN) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the ISBN from JSON.

func (*ISBN) UnmarshalText 

func (u *ISBN) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (ISBN) Value 

func (u ISBN) Value() (driver.Value, error)

Value converts a value to a database driver value.

type ISBN10 

type ISBN10 string

ISBN10 represents an isbn 10 string format.

swagger:strfmt isbn10.

func (*ISBN10) DeepCopy added in v0.19.0 

func (u *ISBN10) DeepCopy() *ISBN10

DeepCopy copies the receiver into a new ISBN10.

func (*ISBN10) DeepCopyInto added in v0.19.0 

func (u *ISBN10) DeepCopyInto(out *ISBN10)

DeepCopyInto copies the receiver and writes its value into out.

func (ISBN10) MarshalBSON added in v0.19.2 

func (u ISBN10) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (ISBN10) MarshalJSON 

func (u ISBN10) MarshalJSON() ([]byte, error)

MarshalJSON returns the ISBN10 as JSON.

func (ISBN10) MarshalText 

func (u ISBN10) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*ISBN10) Scan 

func (u *ISBN10) Scan(raw any) error

Scan read a value from a database driver.

func (ISBN10) String 

func (u ISBN10) String() string

func (*ISBN10) UnmarshalBSON added in v0.19.2 

func (u *ISBN10) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*ISBN10) UnmarshalJSON 

func (u *ISBN10) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the ISBN10 from JSON.

func (*ISBN10) UnmarshalText 

func (u *ISBN10) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (ISBN10) Value 

func (u ISBN10) Value() (driver.Value, error)

Value converts a value to a database driver value.

type ISBN13 

type ISBN13 string

ISBN13 represents an isbn 13 string format.

swagger:strfmt isbn13.

func (*ISBN13) DeepCopy added in v0.19.0 

func (u *ISBN13) DeepCopy() *ISBN13

DeepCopy copies the receiver into a new ISBN13.

func (*ISBN13) DeepCopyInto added in v0.19.0 

func (u *ISBN13) DeepCopyInto(out *ISBN13)

DeepCopyInto copies the receiver and writes its value into out.

func (ISBN13) MarshalBSON added in v0.19.2 

func (u ISBN13) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (ISBN13) MarshalJSON 

func (u ISBN13) MarshalJSON() ([]byte, error)

MarshalJSON returns the ISBN13 as JSON.

func (ISBN13) MarshalText 

func (u ISBN13) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*ISBN13) Scan 

func (u *ISBN13) Scan(raw any) error

Scan read a value from a database driver.

func (ISBN13) String 

func (u ISBN13) String() string

func (*ISBN13) UnmarshalBSON added in v0.19.2 

func (u *ISBN13) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*ISBN13) UnmarshalJSON 

func (u *ISBN13) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the ISBN13 from JSON.

func (*ISBN13) UnmarshalText 

func (u *ISBN13) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (ISBN13) Value 

func (u ISBN13) Value() (driver.Value, error)

Value converts a value to a database driver value.

type ISODuration added in v0.27.0 

type ISODuration[P ISODurationPolicy] time.Duration

ISODuration is an ISO 8601 / RFC 3339 duration (e.g. "P1Y2M3DT4H5M6S", "P2W").

The type parameter P selects the parsing policy at compile time (see ISODurationPolicy). Every instantiation is a distinct type that round-trips through JSON, text, SQL and BSON. Use the DurationISO8601 alias for the strict, spec-compliant default.

Like time.Duration, it stores a nanosecond count; the largest representable duration is approximately 290 years. Calendar units are collapsed to fixed lengths (year = 365 days, month = 30 days), which is lossy by nature.

This generic type carries no swagger:strfmt annotation: go-swagger binds a concrete format name to the DurationISO8601 alias, not to a generic declaration.

Example (Lenient)

Selecting the DurationLenient policy as the type parameter applies the relaxed grammar on the struct-decode path too — useful when consuming feeds that emit fractions or signs. 

package main

import (
	"encoding/json"
	"fmt"
	"time"

	"github.com/go-openapi/strfmt"
)

func main() {
	type Config struct {
		Interval strfmt.ISODuration[strfmt.DurationLenient] `json:"interval"`
	}

	var c Config
	if err := json.Unmarshal([]byte(`{"interval":"PT0.25S"}`), &c); err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(time.Duration(c.Interval))

}

Output:
250ms

func (*ISODuration[P]) DeepCopy added in v0.27.0 

func (d *ISODuration[P]) DeepCopy() *ISODuration[P]

DeepCopy copies the receiver into a new value.

func (*ISODuration[P]) DeepCopyInto added in v0.27.0 

func (d *ISODuration[P]) DeepCopyInto(out *ISODuration[P])

DeepCopyInto copies the receiver into out.

func (ISODuration[P]) Equal added in v0.27.0 

func (d ISODuration[P]) Equal(other ISODuration[P]) bool

Equal reports whether two durations are equal.

func (ISODuration[P]) MarshalBSON added in v0.27.0 

func (d ISODuration[P]) MarshalBSON() ([]byte, error)

MarshalBSON renders the ISODuration as a BSON document.

BSON is a storage boundary (like SQL): the value is emitted losslessly with ISODuration.String, regardless of the policy P — a strict policy that could not serialize a sign or sub-second precision on the interchange path must still be persistable.

func (ISODuration[P]) MarshalJSON added in v0.27.0 

func (d ISODuration[P]) MarshalJSON() ([]byte, error)

MarshalJSON returns the duration as a JSON string, applying the policy P.

func (ISODuration[P]) MarshalText added in v0.27.0 

func (d ISODuration[P]) MarshalText() ([]byte, error)

MarshalText implements encoding.TextMarshaler, applying the policy P: a strict policy errors on a value it cannot represent (see [isoEmit]).

func (*ISODuration[P]) Scan added in v0.27.0 

func (d *ISODuration[P]) Scan(raw any) error

Scan reads a duration (nanoseconds) from a database driver value.

func (ISODuration[P]) String added in v0.27.0 

func (d ISODuration[P]) String() string

String renders the duration in canonical ISO 8601 form.

Unlike ISODuration.MarshalText, String is a best-effort display form: it always renders the true value (lossless), even under a strict policy that could not serialize it (e.g. a sign or sub-second precision).

func (*ISODuration[P]) UnmarshalBSON added in v0.27.0 

func (d *ISODuration[P]) UnmarshalBSON(data []byte) error

UnmarshalBSON reads an ISODuration from a BSON document.

The stored value is our own canonical output, so it is parsed leniently: BSON is trusted storage, not external interchange, and must round-trip whatever ISODuration.MarshalBSON emitted even under a strict policy P.

func (*ISODuration[P]) UnmarshalJSON added in v0.27.0 

func (d *ISODuration[P]) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the duration from a JSON string, applying the policy P.

func (*ISODuration[P]) UnmarshalText added in v0.27.0 

func (d *ISODuration[P]) UnmarshalText(text []byte) error

UnmarshalText implements encoding.TextUnmarshaler, applying the policy P.

func (ISODuration[P]) Value added in v0.27.0 

func (d ISODuration[P]) Value() (driver.Value, error)

Value writes the duration as a nanosecond count.

type ISODurationOption added in v0.27.0 

type ISODurationOption func(*isoDurationConfig)

ISODurationOption relaxes the strict parser on the explicit ParseISO8601Duration path, for programmatic callers.

It has no effect on the registry / struct-field decode path, which is governed by the type's policy.

func WithISOFractions added in v0.27.0 

func WithISOFractions() ISODurationOption

WithISOFractions accepts a decimal fraction on the least significant component.

func WithISOLenient added in v0.27.0 

func WithISOLenient() ISODurationOption

WithISOLenient relaxes every strictness knob (see DurationLenient).

func WithISORelaxedAnchoring added in v0.27.0 

func WithISORelaxedAnchoring() ISODurationOption

WithISORelaxedAnchoring allows gaps in the component chain (e.g. P1Y2D, PT1H2S).

func WithISOSign added in v0.27.0 

func WithISOSign() ISODurationOption

WithISOSign accepts a leading '+' or '-'.

func WithISOSpace added in v0.27.0 

func WithISOSpace() ISODurationOption

WithISOSpace tolerates surrounding whitespace.

func WithISOWeekCombinable added in v0.27.0 

func WithISOWeekCombinable() ISODurationOption

WithISOWeekCombinable allows the 'W' designator to combine with other components.

type ISODurationPolicy added in v0.27.0 

type ISODurationPolicy interface {
	// contains filtered or unexported methods
}

ISODurationPolicy is a compile-time policy selecting the parsing behaviour of an ISODuration.

It is a phantom type parameter: a zero-size value whose single method yields the parser configuration. See DurationStrict and DurationLenient.

type MAC 

type MAC string

MAC represents a 48 bit MAC address.

swagger:strfmt mac.

func (*MAC) DeepCopy added in v0.19.0 

func (u *MAC) DeepCopy() *MAC

DeepCopy copies the receiver into a new MAC.

func (*MAC) DeepCopyInto added in v0.19.0 

func (u *MAC) DeepCopyInto(out *MAC)

DeepCopyInto copies the receiver and writes its value into out.

func (MAC) MarshalBSON added in v0.19.2 

func (u MAC) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (MAC) MarshalJSON 

func (u MAC) MarshalJSON() ([]byte, error)

MarshalJSON returns the MAC as JSON.

func (MAC) MarshalText 

func (u MAC) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*MAC) Scan 

func (u *MAC) Scan(raw any) error

Scan read a value from a database driver.

func (MAC) String 

func (u MAC) String() string

func (*MAC) UnmarshalBSON added in v0.19.2 

func (u *MAC) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*MAC) UnmarshalJSON 

func (u *MAC) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the MAC from JSON.

func (*MAC) UnmarshalText 

func (u *MAC) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (MAC) Value 

func (u MAC) Value() (driver.Value, error)

Value converts a value to a database driver value.

type NameNormalizer 

type NameNormalizer func(string) string

NameNormalizer is a function that normalizes a format name.

The default duration format corresponds to "duration-human".

type ObjectId 

type ObjectId [12]byte //nolint:revive

ObjectId represents a BSON object ID (a 12-byte unique identifier).

swagger:strfmt bsonobjectid.

func NewObjectId 

func NewObjectId(hex string) ObjectId

NewObjectId creates a ObjectId from a hexadecimal String.

func (*ObjectId) DeepCopy added in v0.19.0 

func (id *ObjectId) DeepCopy() *ObjectId

DeepCopy copies the receiver into a new ObjectId.

func (*ObjectId) DeepCopyInto added in v0.19.0 

func (id *ObjectId) DeepCopyInto(out *ObjectId)

DeepCopyInto copies the receiver and writes its value into out.

func (ObjectId) Hex added in v0.26.0 

func (id ObjectId) Hex() string

Hex returns the hex string representation of the ObjectId.

func (ObjectId) MarshalBSON added in v0.19.2 

func (id ObjectId) MarshalBSON() ([]byte, error)

MarshalBSON renders the object id as a BSON document.

func (ObjectId) MarshalBSONValue added in v0.19.2 

func (id ObjectId) MarshalBSONValue() (byte, []byte, error)

MarshalBSONValue marshals the ObjectId as a raw BSON ObjectID value.

func (ObjectId) MarshalJSON 

func (id ObjectId) MarshalJSON() ([]byte, error)

MarshalJSON returns the ObjectId as JSON.

func (ObjectId) MarshalText 

func (id ObjectId) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*ObjectId) Scan 

func (id *ObjectId) Scan(raw any) error

Scan read a value from a database driver.

func (ObjectId) String 

func (id ObjectId) String() string

func (*ObjectId) UnmarshalBSON added in v0.19.2 

func (id *ObjectId) UnmarshalBSON(data []byte) error

UnmarshalBSON reads the objectId from a BSON document.

func (*ObjectId) UnmarshalBSONValue added in v0.19.2 

func (id *ObjectId) UnmarshalBSONValue(_ byte, data []byte) error

UnmarshalBSONValue unmarshals a raw BSON ObjectID value into this ObjectId.

func (*ObjectId) UnmarshalJSON 

func (id *ObjectId) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the ObjectId from JSON.

func (*ObjectId) UnmarshalText 

func (id *ObjectId) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (ObjectId) Value 

func (id ObjectId) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Password 

type Password string

Password represents a password.

This has no validations and is mainly used as a marker for UI components.

swagger:strfmt password.

func (*Password) DeepCopy added in v0.19.0 

func (r *Password) DeepCopy() *Password

DeepCopy copies the receiver into a new Password.

func (*Password) DeepCopyInto added in v0.19.0 

func (r *Password) DeepCopyInto(out *Password)

DeepCopyInto copies the receiver and writes its value into out.

func (Password) MarshalBSON added in v0.19.2 

func (r Password) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (Password) MarshalJSON 

func (r Password) MarshalJSON() ([]byte, error)

MarshalJSON returns the Password as JSON.

func (Password) MarshalText 

func (r Password) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*Password) Scan 

func (r *Password) Scan(raw any) error

Scan read a value from a database driver.

func (Password) String 

func (r Password) String() string

func (*Password) UnmarshalBSON added in v0.19.2 

func (r *Password) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*Password) UnmarshalJSON 

func (r *Password) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the Password from JSON.

func (*Password) UnmarshalText 

func (r *Password) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (Password) Value 

func (r Password) Value() (driver.Value, error)

Value converts a value to a database driver value.

type RGBColor 

type RGBColor string

RGBColor represents a RGB color string format.

swagger:strfmt rgbcolor.

func (*RGBColor) DeepCopy added in v0.19.0 

func (r *RGBColor) DeepCopy() *RGBColor

DeepCopy copies the receiver into a new RGBColor.

func (*RGBColor) DeepCopyInto added in v0.19.0 

func (r *RGBColor) DeepCopyInto(out *RGBColor)

DeepCopyInto copies the receiver and writes its value into out.

func (RGBColor) MarshalBSON added in v0.19.2 

func (r RGBColor) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (RGBColor) MarshalJSON 

func (r RGBColor) MarshalJSON() ([]byte, error)

MarshalJSON returns the RGBColor as JSON.

func (RGBColor) MarshalText 

func (r RGBColor) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*RGBColor) Scan 

func (r *RGBColor) Scan(raw any) error

Scan read a value from a database driver.

func (RGBColor) String 

func (r RGBColor) String() string

func (*RGBColor) UnmarshalBSON added in v0.19.2 

func (r *RGBColor) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*RGBColor) UnmarshalJSON 

func (r *RGBColor) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the RGBColor from JSON.

func (*RGBColor) UnmarshalText 

func (r *RGBColor) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (RGBColor) Value 

func (r RGBColor) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Registry 

type Registry interface {
	Add(name string, strfmt Format, validator Validator) bool
	DelByName(name string) bool
	GetType(name string) (reflect.Type, bool)
	ContainsName(name string) bool
	Validates(name, data string) bool
	Parse(name, data string) (any, error)
	MapStructureHookFunc() mapstructure.DecodeHookFunc
}

Registry is a registry of string formats, with a validation method. 

var Default Registry //nolint:gochecknoglobals // package-level default registry, by design

Default is the default formats registry.

NOTE: format "duration" is wire by default onto "duration-human". 

var JSONSchema2020Registry Registry //nolint:gochecknoglobals // package-level default registry, by design

JSONSchema2020Registry is the format registry with JSONSchema draft 2020 formats (e.g. duration is an iso8601 duration).

func NewFormats 

func NewFormats() Registry

NewFormats creates a new formats registry seeded with the values from the default.

func NewSeededFormats 

func NewSeededFormats(seeds []knownFormat, normalizer NameNormalizer) Registry

NewSeededFormats creates a new formats registry.

type SSN 

type SSN string

SSN represents a social security string format.

swagger:strfmt ssn.

func (*SSN) DeepCopy added in v0.19.0 

func (u *SSN) DeepCopy() *SSN

DeepCopy copies the receiver into a new SSN.

func (*SSN) DeepCopyInto added in v0.19.0 

func (u *SSN) DeepCopyInto(out *SSN)

DeepCopyInto copies the receiver and writes its value into out.

func (SSN) MarshalBSON added in v0.19.2 

func (u SSN) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (SSN) MarshalJSON 

func (u SSN) MarshalJSON() ([]byte, error)

MarshalJSON returns the SSN as JSON.

func (SSN) MarshalText 

func (u SSN) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*SSN) Scan 

func (u *SSN) Scan(raw any) error

Scan read a value from a database driver.

func (SSN) String 

func (u SSN) String() string

func (*SSN) UnmarshalBSON added in v0.19.2 

func (u *SSN) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*SSN) UnmarshalJSON 

func (u *SSN) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the SSN from JSON.

func (*SSN) UnmarshalText 

func (u *SSN) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (SSN) Value 

func (u SSN) Value() (driver.Value, error)

Value converts a value to a database driver value.

type ULID added in v0.20.1 

type ULID struct {
	ulid.ULID
}

ULID represents a ulid string format.

Reference 

https://github.com/ulid/spec

Implementation 

https://github.com/oklog/ulid

swagger:strfmt ulid.

func NewULID added in v0.20.1 

func NewULID() (ULID, error)

NewULID generates new unique ULID value and a error if any.

func NewULIDZero added in v0.20.1 

func NewULIDZero() ULID

NewULIDZero returns a zero valued ULID type.

func ParseULID added in v0.20.1 

func ParseULID(str string) (ULID, error)

ParseULID parses a string that represents an valid ULID.

func (*ULID) DeepCopy added in v0.20.1 

func (u *ULID) DeepCopy() *ULID

DeepCopy copies the receiver into a new ULID.

func (*ULID) DeepCopyInto added in v0.20.1 

func (u *ULID) DeepCopyInto(out *ULID)

DeepCopyInto copies the receiver and writes its value into out.

func (ULID) Equal added in v0.20.1 

func (u ULID) Equal(other ULID) bool

Equal checks if two ULID instances are equal by their underlying type.

func (*ULID) GetULID added in v0.20.1 

func (u *ULID) GetULID() any

GetULID returns underlying instance of ULID.

func (*ULID) GobDecode added in v0.20.1 

func (u *ULID) GobDecode(data []byte) error

GobDecode implements the gob.GobDecoder interface.

func (ULID) GobEncode added in v0.20.1 

func (u ULID) GobEncode() ([]byte, error)

GobEncode implements the gob.GobEncoder interface.

func (ULID) MarshalBSON added in v0.20.1 

func (u ULID) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (ULID) MarshalBinary added in v0.20.1 

func (u ULID) MarshalBinary() ([]byte, error)

MarshalBinary implements the encoding.encoding.BinaryMarshaler interface.

func (ULID) MarshalJSON added in v0.20.1 

func (u ULID) MarshalJSON() ([]byte, error)

MarshalJSON returns the ULID as JSON.

func (ULID) MarshalText added in v0.20.1 

func (u ULID) MarshalText() ([]byte, error)

MarshalText returns this instance into text.

func (*ULID) Scan added in v0.20.1 

func (u *ULID) Scan(raw any) error

Scan reads a value from a database driver.

func (ULID) String added in v0.20.1 

func (u ULID) String() string

func (*ULID) UnmarshalBSON added in v0.20.1 

func (u *ULID) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*ULID) UnmarshalBinary added in v0.20.1 

func (u *ULID) UnmarshalBinary(data []byte) error

UnmarshalBinary implements the encoding.encoding.BinaryUnmarshaler interface.

func (*ULID) UnmarshalJSON added in v0.20.1 

func (u *ULID) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the ULID from JSON.

func (*ULID) UnmarshalText added in v0.20.1 

func (u *ULID) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (ULID) Value added in v0.20.1 

func (u ULID) Value() (driver.Value, error)

Value converts a value to a database driver value.

type URI 

type URI string

URI represents the uri string format as specified by the json schema spec.

swagger:strfmt uri.

func (*URI) DeepCopy added in v0.19.0 

func (u *URI) DeepCopy() *URI

DeepCopy copies the receiver into a new URI.

func (*URI) DeepCopyInto added in v0.19.0 

func (u *URI) DeepCopyInto(out *URI)

DeepCopyInto copies the receiver and writes its value into out.

func (URI) MarshalBSON added in v0.19.2 

func (u URI) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (URI) MarshalJSON 

func (u URI) MarshalJSON() ([]byte, error)

MarshalJSON returns the URI as JSON.

func (URI) MarshalText 

func (u URI) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*URI) Scan 

func (u *URI) Scan(raw any) error

Scan read a value from a database driver.

func (URI) String 

func (u URI) String() string

func (*URI) UnmarshalBSON added in v0.19.2 

func (u *URI) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*URI) UnmarshalJSON 

func (u *URI) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the URI from JSON.

func (*URI) UnmarshalText 

func (u *URI) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (URI) Value 

func (u URI) Value() (driver.Value, error)

Value converts a value to a database driver value.

type UUID 

type UUID string

UUID represents a uuid string format.

swagger:strfmt uuid.

func (*UUID) DeepCopy added in v0.19.0 

func (u *UUID) DeepCopy() *UUID

DeepCopy copies the receiver into a new UUID.

func (*UUID) DeepCopyInto added in v0.19.0 

func (u *UUID) DeepCopyInto(out *UUID)

DeepCopyInto copies the receiver and writes its value into out.

func (UUID) MarshalBSON added in v0.19.2 

func (u UUID) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (UUID) MarshalJSON 

func (u UUID) MarshalJSON() ([]byte, error)

MarshalJSON returns the UUID as JSON.

func (UUID) MarshalText 

func (u UUID) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*UUID) Scan 

func (u *UUID) Scan(raw any) error

Scan read a value from a database driver.

func (UUID) String 

func (u UUID) String() string

func (*UUID) UnmarshalBSON added in v0.19.2 

func (u *UUID) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*UUID) UnmarshalJSON 

func (u *UUID) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the UUID from JSON.

func (*UUID) UnmarshalText 

func (u *UUID) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (UUID) Value 

func (u UUID) Value() (driver.Value, error)

Value converts a value to a database driver value.

type UUID3 

type UUID3 string

UUID3 represents a uuid3 string format.

swagger:strfmt uuid3.

func (*UUID3) DeepCopy added in v0.19.0 

func (u *UUID3) DeepCopy() *UUID3

DeepCopy copies the receiver into a new [UUID]3.

func (*UUID3) DeepCopyInto added in v0.19.0 

func (u *UUID3) DeepCopyInto(out *UUID3)

DeepCopyInto copies the receiver and writes its value into out.

func (UUID3) MarshalBSON added in v0.19.2 

func (u UUID3) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (UUID3) MarshalJSON 

func (u UUID3) MarshalJSON() ([]byte, error)

MarshalJSON returns the UUID3 as JSON.

func (UUID3) MarshalText 

func (u UUID3) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*UUID3) Scan 

func (u *UUID3) Scan(raw any) error

Scan read a value from a database driver.

func (UUID3) String 

func (u UUID3) String() string

func (*UUID3) UnmarshalBSON added in v0.19.2 

func (u *UUID3) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*UUID3) UnmarshalJSON 

func (u *UUID3) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the UUID3 from JSON.

func (*UUID3) UnmarshalText 

func (u *UUID3) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (UUID3) Value 

func (u UUID3) Value() (driver.Value, error)

Value converts a value to a database driver value.

type UUID4 

type UUID4 string

UUID4 represents a uuid4 string format.

swagger:strfmt uuid4.

func (*UUID4) DeepCopy added in v0.19.0 

func (u *UUID4) DeepCopy() *UUID4

DeepCopy copies the receiver into a new UUID4.

func (*UUID4) DeepCopyInto added in v0.19.0 

func (u *UUID4) DeepCopyInto(out *UUID4)

DeepCopyInto copies the receiver and writes its value into out.

func (UUID4) MarshalBSON added in v0.19.2 

func (u UUID4) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (UUID4) MarshalJSON 

func (u UUID4) MarshalJSON() ([]byte, error)

MarshalJSON returns the UUID4 as JSON.

func (UUID4) MarshalText 

func (u UUID4) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*UUID4) Scan 

func (u *UUID4) Scan(raw any) error

Scan read a value from a database driver.

func (UUID4) String 

func (u UUID4) String() string

func (*UUID4) UnmarshalBSON added in v0.19.2 

func (u *UUID4) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*UUID4) UnmarshalJSON 

func (u *UUID4) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the UUID4 from JSON.

func (*UUID4) UnmarshalText 

func (u *UUID4) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (UUID4) Value 

func (u UUID4) Value() (driver.Value, error)

Value converts a value to a database driver value.

type UUID5 

type UUID5 string

UUID5 represents a uuid5 string format.

swagger:strfmt uuid5.

func (*UUID5) DeepCopy added in v0.19.0 

func (u *UUID5) DeepCopy() *UUID5

DeepCopy copies the receiver into a new UUID5.

func (*UUID5) DeepCopyInto added in v0.19.0 

func (u *UUID5) DeepCopyInto(out *UUID5)

DeepCopyInto copies the receiver and writes its value into out.

func (UUID5) MarshalBSON added in v0.19.2 

func (u UUID5) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (UUID5) MarshalJSON 

func (u UUID5) MarshalJSON() ([]byte, error)

MarshalJSON returns the UUID5 as JSON.

func (UUID5) MarshalText 

func (u UUID5) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*UUID5) Scan 

func (u *UUID5) Scan(raw any) error

Scan read a value from a database driver.

func (UUID5) String 

func (u UUID5) String() string

func (*UUID5) UnmarshalBSON added in v0.19.2 

func (u *UUID5) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*UUID5) UnmarshalJSON 

func (u *UUID5) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the UUID5 from JSON.

func (*UUID5) UnmarshalText 

func (u *UUID5) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (UUID5) Value 

func (u UUID5) Value() (driver.Value, error)

Value converts a value to a database driver value.

type UUID7 added in v0.25.0 

type UUID7 string

UUID7 represents a uuid7 string format.

swagger:strfmt uuid7.

func (*UUID7) DeepCopy added in v0.25.0 

func (u *UUID7) DeepCopy() *UUID7

DeepCopy copies the receiver into a new [UUID]7.

func (*UUID7) DeepCopyInto added in v0.25.0 

func (u *UUID7) DeepCopyInto(out *UUID7)

DeepCopyInto copies the receiver and writes its value into out.

func (UUID7) MarshalBSON added in v0.25.0 

func (u UUID7) MarshalBSON() ([]byte, error)

MarshalBSON document from this value.

func (UUID7) MarshalJSON added in v0.25.0 

func (u UUID7) MarshalJSON() ([]byte, error)

MarshalJSON returns the UUID7 as JSON.

func (UUID7) MarshalText added in v0.25.0 

func (u UUID7) MarshalText() ([]byte, error)

MarshalText turns this instance into text.

func (*UUID7) Scan added in v0.25.0 

func (u *UUID7) Scan(raw any) error

Scan read a value from a database driver.

func (UUID7) String added in v0.25.0 

func (u UUID7) String() string

func (*UUID7) UnmarshalBSON added in v0.25.0 

func (u *UUID7) UnmarshalBSON(data []byte) error

UnmarshalBSON document into this value.

func (*UUID7) UnmarshalJSON added in v0.25.0 

func (u *UUID7) UnmarshalJSON(data []byte) error

UnmarshalJSON sets the UUID7 from JSON.

func (*UUID7) UnmarshalText added in v0.25.0 

func (u *UUID7) UnmarshalText(data []byte) error

UnmarshalText hydrates this instance from text.

func (UUID7) Value added in v0.25.0 

func (u UUID7) Value() (driver.Value, error)

Value converts a value to a database driver value.

type Validator 

type Validator func(string) bool

Validator represents a validator for a string format.

Source Files

View all Source files

Directories

Path Synopsis
enable
mongodb module
internal
bsonlite
Package bsonlite provides a minimal BSON codec for strfmt types.
 Package bsonlite provides a minimal BSON codec for strfmt types.
countries
testintegration module

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.