pxt-microbit/docs/reference/input/temperature.md

micro:bit target for Microsoft MakeCode (PXT)

# Temperature

Find the temperature where you are. The temperature is measured in Celsius (metric).
The @boardname@ can find the temperature nearby by checking how hot its computer chips are.

```sig
input.temperature();
```

## Returns

* a [number](/types/number) that is the temperature in degrees Celsius.

## How does it work?

The @boardname@ checks how hot its CPU (main computer chip) is.
Because the @boardname@ does not usually get very hot, the temperature of the CPU
is usually close to the temperature of wherever you are.
The @boardname@ might warm up a little if you make it work hard, though!

Learn more about how the @boardname@ can detect hot or cold in this video:

https://www.youtube.com/watch?v=_T4N8O9xsMA


## Example: @boardname@ thermometer

The following example uses `temperature` and `show number` to show the temperature of the room.

```blocks
basic.forever(() => {
    let temp = input.temperature()
    basic.showNumber(temp)
})
```
## Example: Fahrenheit thermometer

This program measures the temperature using Fahrenheit degrees.
Fahrenheit is a way of measuring temperature that is commonly used in the United States.
To make a Celsius temperature into a Fahrenheit one, multiply the Celsius temperature by
``1.8`` and add ``32``.

```blocks
basic.forever(() => {
    let c = input.temperature()
    let f = (1.8 * c) + 32
    basic.showNumber(f)
})
```

## ~hint

Try comparing the temperature your @boardname@ shows to a real thermometer in the same place.
You might be able to figure out how much to subtract from the number the @boardname@
shows to get the real temperature. Then you can change your program so the @boardname@ is a 
better thermometer.

## ~

## See also

[compass-heading](/reference/input/compass-heading), [acceleration](/reference/input/acceleration)