help:number syntax

Number syntax has two different forms, depending on whether it's part of a field search or a post search.

Integer / Float / Datetime / Interval fields

When searching with numbers, the following variation in search parameters may be used.

Direct comparisons

These take the text field in its entirety when making the comparison as selected by the qualifier. The following qualifiers are available.

  • (No qualifier) - Basic comparison.
  • *_not - Basic comparison (negated).
  • *_eq - Direct comparison.
  • *_not_eq - Direct inequality comparison.
  • *_gt - Greater-than comparison.
  • *_gteq - Greater-than or equal comparison.
  • *_lt - Less-than comparison.
  • *_lteq - Less-than or equal comparison.

Example:

search[id_eq]=100

Searches for records where the ID is 100.

Basic syntax
Multiple values
  • 100,200,300 (the values 100, 200 and 300)
Less than or equal to
  • <100 (less than only)
  • <=100 (less than or equal to)
Greater than or equal to
  • >100 (greater than only)
  • >=100 (greater than or equal to)
Intervals
  • 100..200 (all numbers between 100 and 200, inclusive)
  • 100...200 (all numbers between 100 and 200, excludes 200)
  • ..100 (equivalent to <=100)
  • 100.. (equivalent to >=100)

Note: intervals only work from low to high, i.e. 100..200 will work while 200..100 won't.

Combination values/intervals
  • 98,100..200,202 (all numbers between 100 and 200, inclusive, plus 98 and 202)
Absolutes
  • none (null values)
  • any (non-null values)

Post search

In post searches, the syntax goes like this:

[metatag]:[number]

Example:

id:100

Values can be passed in using the basic syntax.

Examples:

width:<=100 mpixels:5.. id:100..200

Metatags where basic syntax can be used
  • id
  • width
  • height
  • score
  • mpixels
  • ratio
  • filesize
  • age
  • date
  • tagcount
  • gentags
  • arttags
  • chartags
  • copytags
  • pixiv
  • pixiv_id
Metatags where basic syntax cannot be used
  • limit
  • parent
  • child
  • pool
Units

With certain metatags, units are used. The basic syntax works the same with units.

Syntax:

[metatag]:[number][unit]

Example:
age:..10weeks

Age units

These units are used together with the age metatag.

  • seconds (s)
  • minutes (mi)
  • hours (h)
  • days (d)
  • weeks (w)
  • months (mo)
  • years (y)

The shorthand version is in parenthesis. You can use any number of characters between the shorthand version and full version. For example, "se" or "sec" work in place of s or seconds.

Example:
age:2weeks..1mo

Note: not specifying the time unit is no longer supported and will return no results. "m" will also return no results as it is ambiguous between minutes and months.

Note: singular and plural forms of units can be used interchangeably.

Filesize units

These units are used together with the filesize metatag.

  • b (bytes)
  • kb (kilobytes)
  • m (megabytes)

Only the shorthand versions will work, i.e. bytes, kilobytes and megabytes are not part of the syntax.

Example:
filesize:<=10kb

Note: if no unit is specified it defaults to bytes.

Note: for anyone curious, 1m = 1024kb and 1kb = 1024b.

Ratios

For the metatag ratio, fractions are commonly used but you may use decimal notation also.

The aspect ratio denotes the relationship between the width and height of an image. For example, a 1:1 ratio means the width and height are equal whereas a 4:3 ratio means the width is one third longer (4/3) than the height. Useful aspect ratio tool: http://andrew.hedges.name/experiments/aspect_ratio/

Syntax:

ratio:[width]/[height]
ratio:[number]

Examples:

Note: colons are supported in place of slashes; e.g., ratio:16:9.

Note: using ratios won't always result in pixel perfect results as the ratios are rounded to two decimal points, i.e. a search for ratio:16/9 may result in a picture with the dimensions 1920x1078 instead of 1920x1080.

Why should you use ratios?

Ratios can be used to assist in finding wallpapers. For example, if you have a 1920x1080 monitor, you can use ratio:16/9 width:>=1920 to find wallpapers for it.

Tip

If you want to avoid calculating ratios altogether, then you can use dimensions directly.

Example:
ratio:1920/1200 is equivalent to ratio:8/5

Basic syntax

You can use basic syntax with ratios; though, take note if you use fractions.

First, the site will calculate all fractions into a decimal notation and round it off to two decimals, e.g. ratio:16:9 becomes ratio:1.78.

At this point it's regular numbers and normal basic syntax will work as expected.

Example:
ratio:16/10..16/9 becomes ratio:1.6..1.78 (Note: 16/9..16/10 won't work. See under Intervals on this page)
ratio:..16/9 becomes ratio:..1.78

See also